NWUXGetByteFunctions

Returns the functions used for handling unmappable bytes

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) NWUXGetByteFunctions  ( 
      pCONVERT   byteUniHandle,  
      NMBYTE    *noMapByteFunc,  
      SCBYTE    *scanByteFunc,  
      PRBYTE    *parseByteFunc);
   

Pascal Syntax

   uses netwin32 
    
   Function NWUXGetByteFunctions 
     (byteUniHandle : pCONVERT;
     noMapByteFunc : NMBYTE;
     scanByteFunc : SCBYTE
     parseByteFunc : PRBYTE              
   ): nint;
   

Parameters

byteUniHandle
(IN) Points to the converter handle.
noMapByteFunc
(OUT) Points to the function to be called when an unmappable byte sequence is found (or set to NULL).
scanByteFunc
(OUT) Points to the function to scan for special data (or set to NULL).
parseByteFunc
(OUT) Points to the function to parse special data (or set to NULL).

Return Values

0x0000

SUCCESSFUL

0xFDE9

NWU_NULL_HANDLE

0xFDEA

NWU_BAD_HANDLE

0xFDEB

NWU_HANDLE_MISMATCH

Remarks

The system-supplied NoMap byte function, which is not enabled by default, converts an unmappable byte 0xNN into the unicode string "[NN]".

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

See exgbfunc.c for sample code.

See Also

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