_NutPathToWin32FS()

convert NuTCRACKER Platform path names to Windows path names with forward slashes 

Function


SYNOPSIS

#include <winnutc.h>

BOOL _NutPathToWin32FS(const char *pathname, char *win32path, BOOL absname);


DESCRIPTION

The _NutPathToWin32FS() function converts any of the NuTCRACKER Platform-type path names to a Win32 path name with forward slashes (for example, with the drive letter specified as D:/).

You should ensure that the buffer that win32path points to is at least as large as the buffer that pathname points to. Buffers should be allocated with PATH_MAX+1 characters.


PARAMETERS

pathname 

Points to the path name to be converted.

win32path 

Points to a buffer that contains the converted path name.

absname 

When TRUE, this function converts a relative path to an absolute path.


RETURN VALUES

If successful, _NutPathToWin32FS() returns TRUE. On failure, it returns FALSE and sets errno to on of the following values:

EFAULT 

pathname or win32path points is an invalid pointer.

EINVAL 

pathname is invalid or nonexistent.

ENAMETOOLONG 

The length of pathname exceeds PATH_MAX or the length of a pathname component exceeds NAME_MAX while _POSIX_NO_TRUNC is in effect.

ENOENT 

The buffer that pathname points to is empty.


CONFORMANCE

PTC MKS Toolkit UNIX APIs extension.


MULTITHREAD SAFETY LEVEL

MT-Safe.


PORTING ISSUES

Refer to File Management in the Windows Concepts chapter of the cpdevguide; for more information about the various path name formats supported by the NuTCRACKER Platform.


AVAILABILITY

PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition


SEE ALSO

Functions:
_NutPathToNutc(), _NutPathToWin32()


PTC MKS Toolkit 10.4 Documentation Build 39.