Syntax

   #include <nunicode.h> 
    
   N_EXTERN_LIBRARY(nint) NWUXLoadByteUnicodeConverter  ( 
      nuint             codepage,  
      pCONVERT N_FAR   *byteUniHandle);
   

Pascal Syntax

   uses netwin32 
    
   Function NWUXLoadByteUnicodeConverter 
     (codepage : nuint;
     byteUniHandle : pCONVERT           
   ): nint;
   

Parameters

codepage

(IN) Specifies the code page to use. Pass zero to use the system code page.

byteUniHandle

(OUT) Points to the Unicode/byte converter handle. If an error occurs, the handle is set to NULL.

Return Values

For an explanation of the NWU_CONVERTER_NOT_FOUND error, see NWU_CONVERTER_NOT_FOUND Error

Remarks

NWUXLoadByteUnicodeConverter can be called multiple times with different code pages. This functionality allows you to perform operations involving multiple code pages. A different handle will be returned for each separate call.

Each call to NWUXLoadByteUnicodeConverter should have a corresponding call to NWUXUnloadConverter to release converter resources when they are no longer needed. To unload the appropriate converter, pass in the handle returned from the corresponding call to NWUXLoadByteUnicodeConverter.

If codepage is set to zero, the system code page will be used.

Conversions are performed according to standard Novell default behavior unless another behavior is specified through other functions.

See exldbu.c for sample code.

See Also

NWUXLoadCaseConverter, NWUXUnloadConverter