NWUSStandardUnicodeInit

Loads both the lower and upper case converters needed for the standard Unicode functions

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) NWUSStandardUnicodeInit  ( 
      void);

Pascal Syntax

   uses netwin32 
    
   Function NWUSStandardUnicodeInit 
     (void              
   ): nint;

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

The NWUSStandardUnicodeInit function is equivalent to:

  • loading the appropriate Unicode to byte converter for the current code page
  • loading a lower case and an upper case converter
  • setting the converter to use the default substitution character for unmappable bytes
  • enabling the default no map and scan/parse Unicode handlers

NWUSStandardUnicodeInit can be nested. However, each time NWUSStandardUnicodeInit is called, the NWUSStandardUnicodeRelease function must be called to release associated resources.

On the NLM platform, the standard converter is initialized when the LOCNLM32.NLM file is loaded. It is still recommended that your applications call NWUSStandardUnicodeInit and the NWUSStandardUnicodeRelease function explicitly.

See esinit.c for sample code.

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

See Also

NWUSStandardUnicodeRelease