_NutPathToWin32()

convert NuTCRACKER Platform-style path names to Windows-style path names 

Function


SYNOPSIS

#include <winnutc.h>

BOOL _NutPathToWin32(const char *Pathname, char *win32path, BOOL absname);


DESCRIPTION

The _NutPathToWin32() function converts any of the NuTCRACKER Platform type path names to a Win32 path name (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, _NutPathToWin32() returns TRUE. On failure, it returns FALSE and sets errno to one of the following values:

EFAULT 

pathname or win32path 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 PTC MKS Toolkit UNIX to Windows Porting Guide 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(), _NutPathToWin32FS()


PTC MKS Toolkit 10.3 Documentation Build 39.