NWUSLenByteToUnicodePath
Converts a length-specified file path byte string into a Unicode string
#include <nunicode.h> N_EXTERN_LIBRARY(nint) NWUSLenByteToUnicodePath ( punicode unicodeOutput, nuint outputBufferLen, const nuint8 N_FAR *byteInput, nuint inLength, pnuint actualLength);
uses netwin32 Function NWUSLenByteToUnicodePath (unicodeOutput : punicode; outputBufferLen : nuint; byteInput : const nuint8; inLength : nuint; actualLength : pnuint ): nint;
Call NWUSLenByteToUnicodePath whenever the byte string to be converted is a file path.
NWUSLenByteToUnicodePath converts an unmappable byte into the substitute Unicode character.
NWUSLenByteToUnicodePath converts a special byte sequence into a Unicode character. For example, "[2620]" is converted to the single Unicode character, 0x2620.
Call NWUSLenByteToUnicodePath to determine the size of the string before it is converted by setting the unicodeOutput parameter to NULL. The outputBufferLen parameter will be ignored, a converted string will not be returned, and the length of the string if it were converted will be returned in the actualLength parameter.
To determine the behavior of NWUSLenByteToUnicodePath when an embedded NULL is encountered, see Length-Specified Byte String Conversion.
See eslbunip.c for sample code.