GetCodePage

La funzione SNA National Language Support (SNANLS) GetCodePage copia le informazioni della tabella codici identificate da una chiave in una struttura passata come parametro.

Sintassi

  
BOOL WINAPI GetCodePage(   
        Int nKey  
struct CodePage *pPage  
);  

Parametri

nKey
Parametro fornito. Chiave numerica in una tabella codici. Questo valore è un indice opaco in una matrice contenente le tabelle codici supportate da SNANLS. Questo valore è in genere il membro CodePageKey di una struttura CodePage restituito da una chiamata precedente a FindFirstCodePage o FindNextCodePage.

pPage
Parametro fornito e restituito. Puntatore allo struct CodePage in cui devono essere copiate le informazioni della tabella codici.

In caso di esito positivo, il percorso di memoria a cui punta questo parametro verrà compilato con le informazioni per la tabella codici specifica.

In caso di errore, non verranno apportate modifiche alla memoria a cui punta questo parametro.

Lo struct CodePage è definito in SNANLS. H include file come segue:

struct CodePage {  
    BYTE    CodePageKey;  
    DWORD   CodePageID;  
    WCHAR   szFriendlyName[CP_SIZE];  
    short   eGroup;  
    BOOL    bAvailable;  
    BYTE    bccsid;  
    BOOL    bEuro;  
};  

I membri di questa struttura CodePage sono i seguenti:

CodePageKey

Valore numerico che rappresenta l'indice nella matrice di strutture CodePage. Questo valore deve essere usato come valore opaco, poiché questo valore può essere modificato arbitrariamente dai Service Pack quando sono supportate altre tabelle codici.

CodePageID

Numero della tabella codici NLS.

szFriendlyName

Nome visualizzato SNANLS per questa tabella codici. La stringa di caratteri è null terminata.

eGroup

Gruppo rappresentato da questa tabella codici. . Questo valore può essere rappresentato da una delle enumerazioni seguenti definite nel file di inclusione SNANLS.h per i gruppi di codice:

ENUM_CP_EBCDIC

Questa tabella codici è un membro del gruppo di tabelle codici EBCDIC.

ENUM_CP_ANSI

Questa tabella codici è un membro del gruppo di tabelle codici ANSI.

ENUM_CP_ISO

Questa tabella codici è un membro del gruppo di tabelle codici ISO.

ENUM_CP_OEMPC

Questa tabella codici è un membro del gruppo di tabelle codici del PC OEM.

ENUM_CP_ISO

Questa tabella codici è un membro del gruppo di tabelle codici ISO.

ENUM_CP_ISO

Questa tabella codici è un membro del gruppo di tabelle codici ISO.

ENUM_CP_OEM PC

Questa tabella codici è un membro del gruppo di tabelle codici del PC OEM.

ENUM_CP_OPEN

Questa tabella codici è un membro del gruppo di tabelle codici Open Systems.

ENUM_CP_UCS

Questa tabella codici è un membro del gruppo di tabelle codici UCS.

bAvailable

Valore booleano utilizzato per indicare che la tabella codici è installata nel computer. Il valore FALSE per questo membro indica che il computer non verrà sottoposto a query per determinare se questa tabella codici è installata. Il valore TRUE indica che è installata la tabella codici.

bccsid

Flag utilizzato per indicare il tipo di tabella codici. Questo flag può essere uno dei seguenti:

ENUM_CP_DBCS (0x08)

La tabella codici è per un set di caratteri a byte doppio.

ENUM_CP_MBCS (0x10)

La tabella codici è per un set di caratteri a byte misto.

ENUM_CP_SBCS (0x20)

La tabella codici è per un set di caratteri a byte singolo.

bEuro

Valore booleano utilizzato per indicare se questa tabella codici supporta il simbolo Euro. Se questo valore è TRUE, il simbolo dell'euro è supportato.

Valore restituito

La funzione GetCodePage restituisce un valore TRUE in caso di esito positivo. In caso di errore, il valore restituito è FALSE.

Commenti

Questa funzione è supportata da SNANLS in Host Integration Server.