_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

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

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


SEE ALSO

Functions:
_NutPathToNutc(), _NutPathToWin32()


MKS Toolkit 9.2 Documentation Build 16.