NWUXGetUniFunctions

Returns the functions used for handling unmappable Unicode characters

Local Servers:nonblocking
Remote Servers:N/A
NetWare Server:4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows95, Windows 98
Library:Cross-Platform Localization (LOC*.*)
Service:Unicode

Syntax

   #include <nunicode.h> 
    
   N_EXTERN_LIBRARY(nint) NWUXGetUniFunctions  ( 
      pCONVERT   byteUniHandle,  
      NMUNI     *noMapUniFunc,  
      SCUNI     *scanUniFunc,  
      PRUNI     *parseUniFunc);
   

Pascal Syntax

   uses netwin32 
    
   Function NWUXGetUniFunctions 
     (byteUniHandle : pCONVERT;
     noMapUniFunc : NMUNI;
     scanUniFunc : SCUNI;
     parseUniFunc : PRUNI           
   ): nint;
   

Parameters

byteUniHandle
(IN) Points to the converter handle.
noMapByteFunc
(OUT) Points to the Unicode function to be called when unmappable Unicode characters are found.
scanByteFunc
(OUT) Points to the Unicode function to scan for special data.
parseByteFunc
(OUT) Points to the Unicode function to parse special data.

Return Values

0x0000

SUCCESSFUL

0xFDE9

NWU_NULL_HANDLE

0xFDEA

NWU_BAD_HANDLE

0xFDEB

NWU_HANDLE_MISMATCH

Remarks

The system-supplied NoMap Unicode function, which is enabled by default, converts an unmappable Unicode character 0xNNNN into the byte string "[NNNN]".

The system-supplied scan/parse Unicode functions, which are not enabled by default, scan for occurrences of the Unicode string "[NN]" (NN being any two hexadecimal digits) and converts the string to the single byte character 0xNN.

See exgufunc.c for sample code.

See Also

NWUXGetByteFunctions, NWUXGetNoMapAction, NWUXGetSubByte, NWUXGetSubUni, NWUXSetByteFunctions, NWUXSetNoMapAction, NWUXSetSubByte, NWUXSetSubUni, NWUXSetUniFunctions