NWUXSetSubUni

Specifies the substitution character 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) NWUXSetSubUni  ( 
      pCONVERT   byteUniHandle,  
      Unicode    subsituteUni);
   

Pascal Syntax

   uses netwin32 
    
   Function NWUXSetSubUni 
     (byteUniHandle : pCONVERT;
     substituteUni : Unicode
   ): nint;
   

Parameters

byteUniHandle
(IN) Points to the converter handle.
substituteUni
(OUT) Receives the new substitution character.

Return Values

0x0000

SUCCESSFUL

0xFDE9

NWU_NULL_HANDLE

0xFDEA

NWU_BAD_HANDLE

0xFDEB

NWU_HANDLE_MISMATCH

Remarks

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

NWUXSetSubUni does not set the NoMap byte action to be followed to NWU_SUBSTITUTE. NoMap byte action must be set by calling the NWUXSetNoMapAction function.

See exssubu.c for sample code.

See Also

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