_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.5 Documentation Build 40.