NWUSStandardUnicodeOverride

Replaces the current standard converter with a converter for the specified codepage

Local Servers:blocking
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) NWUSStandardUnicodeOverride ( 
      nuint   codepage);
   

Pascal Syntax

   uses netwin32 
    
   Function NWUSStandardUnicodeOverride 
     (codepage : nuint
   ): nint;
   

Parameters

codepage
(IN) Specifies the codepage of the replacement standard converter.

Return Values

0x0000

SUCCESSFUL

0xFDE8

NWU_CONVERTER_CORRUPT

0xFDE6

NWU_OUT_OF_MEMORY

0xFDE5

NWU_READ_FAILED (NIOS only)

0xFDE4

NWU_OPEN_FAILED (NIOS only)

0xFDE3

NWU_NO_PERMISSION (NIOS only)

0xFDE2

NWU_TOO_MANY_FILES (NIOS only)

0xFDE1

NWU_CONVERTER_NOT_FOUND

For an explanation of the NWU_CONVERTER_NOT_FOUND error, see NWU_CONVERTER_NOT_FOUND Error

Remarks

NWUSStandardUnicodeOverride replaces the current standard Unicode converter with the converter specified in the codepage parameter. The specified converter performs all standard Unicode conversions until it is changed with another call to NWUSStandardUnicodeOverride or is released with a call to NWUSStandardUnicodeRelease.

If a standard converter has not been loaded with a call to NWUSStandardUnicodeInit, a call to NWUSStandardUnicodeOverride initializes the specified standard converter and sets up global variables needed for standard Unicode conversions.

NWUSStandardUnicodeOverride cannot be nested as can NWUSStandardUnicodeInit. However, NWUSStandardUnicodeOverride can be called multiple times to change standard converters.

When conversion operations are completed, release the current converter and associated resources by calling NWUSStandardUnicodeRelease.

NOTE:Access to global variables initialized with a standard converter can vary according to platform, as explained in Conversion Operations.

See Also

NWUSStandardUnicodeInit, NWUSStandardUnicodeRelease