UniGetMacintoshTable

Gets a Macintosh* table cookie for the specified code page.

Library:LibC
Service:Characters and Strings

Syntax

  #include <unilib.h> 
   
  int  UniGetMacintoshTable (
     const char       *name,
     UniRuleTable_t   *table);
  

Parameters

name

(IN) Specifies which Macintosh code page to obtain a translation table for. The following case-insensitive strings are currently supported:

Primary Value

Other Values

Central European

centeuro

Chinese Simplified

chinsimp

Chinese Traditional

chintrad

Corporate-zone Characters

corpchar

Cyrillic

Ukrainian or Ukraine

Croatian

Devanagari

devanaga

Dingbats

Farsi

Greek

Gujarati

Gurmukhi

Hebrew

Icelandic

iceland

Japanese

Keyboard Characters

keyboard

Korean

Roman

Romanian

Symbol

Thai

Turkish

table

(OUT) Points to the cookie for the translation table.

Return Values

If successful, returns 0. Otherwise, returns a negative error code and the value of table is undefined.

Decimal

Name

Description

-494

UNI_ERR_MEM_ALLOC

No memory is available for allocation.

-498

UNI_ERR_TABLE_CORRUPT

Table corruption has been detected.

-501

UNI_ERR_FILE_OPEN

Unable to open the table file.

-504

UNI_ERR_FILE_READ

Unable to read the table file.

Remarks

A Macintosh component, service, or application must explicitly request that a table be loaded and pass the cookie associated with that table to functions requiring table information to perform their task. Table cookies are obtained by calling UniGetMacintoshTable. The corresponding call to dispose of these tables is UniDisposeTable.

The table files are located in an nls subdirectory of the one where server.exe was installed. If the UniGetMacintoshTable function yields I/O errors when opening a previously unused code page table for reading, the most likely reason is that the file is absent or corrupted. The name of the file corresponds closely with the value passed in name parameter, but truncated to an 8-character name.

See Also