NWUXSetNoMapAction

Sets the actions to follow when an unmappable byte or an unmappable Unicode character is found

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) NWUXSetNoMapAction  ( 
      pCONVERT   byteUniHandle,  
      nint       noMapByteAction,  
      nint       noMapUniAction);

Pascal Syntax

   uses netwin32 
    
   Function NWUXSetNoMapAction 
     (byteUniHandle : pCONVERT;
     noMapByteFunc : nint;
     noMapUniFunc : nint;
   ): nint;

Parameters

byteUniHandle
(IN) Points to the converter handle.
noMapByteAction
(IN) Specifies the action to follow for unmappable bytes during byte-to-Unicode conversion.
noMapUniAction
(IN) Specifies the action to follow for unmappable Unicode characters during Unicode-to-byte conversion.

Return Values

0x0000

SUCCESSFUL

0xFDE9

NWU_NULL_HANDLE

0xFDEA

NWU_BAD_HANDLE

0xFDEB

NWU_HANDLE_MISMATCH

0xFDED

NWU_RANGE_ERROR

Remarks

Values for either the noMapByteAction or noMapUniAction parameter are:

NWU_RETURN_ERROR

Returns an error code of NWU_UNMAPPABLE_CHAR.

NWU_SUBSTITUTE

Uses the current substitute byte if converting to bytes, or the current substitution character if converting to Unicode characters.

NWU_CALL_HANDLER

Calls the current NoMap handler. User defined handlers may be specified by calling the NWUXSetByteFunctions or NWUXSetUniFunctions functions.

NWU_UNCHANGED_ACTION

Leaves the current setting unchanged.

See exsnomap.c for sample code.

See Also

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