NWUXSetSubByte

Specifies the substitution byte for the converter

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) NWUXSetSubByte  ( 
      pCONVERT   byteUniHandle,  
      nuint8     substituteByte);
   

Pascal Syntax

   uses netwin32 
    
   Function NWUXSetSubByte 
     (byteUniHandle : pCONVERT;
     substituteByte : nuint8
   ): nint;
   

Parameters

byteUniHandle
(IN) Points to the converter handle.
substituteByte
(IN) Specifies the new substitution byte.

Return Values

0x0000

SUCCESSFUL

0xFDE9

NWU_NULL_HANDLE

0xFDEA

NWU_BAD_HANDLE

0xFDEB

NWU_HANDLE_MISMATCH

Remarks

During a Unicode to byte conversion, the substitution byte is written to the output buffer if an unmappable Unicode character is found and the current action is set to NWU_SUBSTITUTE.

NWUXSetSubByte does not set the NoMap Unicode action to NWU_SUBSTITUTE. NoMap Unicode action must be set by calling the NWUXSetNoMapAction function.

See exssubb.c for sample code.

See Also

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