Previous

Next

Function rtsmb_set_codepage

rtsmb_set_codepage can be used to supply translation tables for Unicode file names received from the SMB client. If the function is never called, OEM code page 437 is assumed by default.

void rtsmb_set_codepage(int             CodePage, 
                        const wchar_t * Unicode, 
                        const char    * UpperCase);

Parameters

CodePage

Numeric name of the code page.

Unicode

Pointer to an array of exactly 128 wchar_t values. This array must contain the Unicode translations of the 8-bit ASCII values in range 128..255. The SMB server will translate ASCII character values above 127 to Unicode with: Unicode[(BYTE) c - 128].

UpperCase

Pointer to an array of exactly 128 char values. This array must contain the upper case repesentation of each 8-bit ASCII value in range 128..255. If there is no upper case translation for a character, the character itself should appear at its corresponding index.

The code page installed through this function must match the code page expected by the file system implementing network shares. For example, applications using RTFiles-32 should also call RTFSetCodePage with the same parameters when this function is called.

This function is shared among the SMB server and SMB client. For applications using both the SMB server and SMB client, this function changes the code page for the server and the client with a single call.

Through rtsmb_set_codepage, the SMB server can support any ASCII code page. Function rtsmb_set_codepage_OEM, and rtsmb_set_codepage_ANSI call rtsmb_set_codepage internally for code pages 437 and 1252, respectively. To use UTF-8 encoding, use function rtsmb_set_codepage_UTF8.

SMB Server

Function rtsmb_server

Function rtsmb_set_codepage_OEM