FindFirstCodePage

La funzione SNA National Language Support (SNANLS) FindFirstCodePage trova la prima istanza di una tabella codici che soddisfa la condizione specificata, copia le informazioni della tabella codici in una struttura passata come parametro e apre e restituisce un handle usato nelle chiamate successive alla funzione FindNextCodePage .

Sintassi

  
const HANDLE WINAPI FindFirstCodePage(   
        DWORDdwEnumOption,  
        struct CodePage *pPage  
);  

Parametri

dwEnumOption
Parametro fornito. Set di condizioni che una tabella codici deve soddisfare. Queste condizioni possono essere qualsiasi combinazione dei valori seguenti definiti nel file di inclusione SNANLS.h:

ENUM_CP_AVAILABLE (0x01)

La tabella codici è installata e disponibile per l'uso.

ENUM_CP_HOST (0x02)

La tabella codici è una tabella codici host ,ad esempio EBCDIC.

ENUM_CP_EURO (0x04)

La tabella codici contiene il supporto per il carattere euro.

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.

Si noti che alcune di queste combinazioni rappresentano casi che non corrispondono ad alcuna tabella codici installata usata da SNANLS.

pPage
Parametro fornito e restituito. Puntatore a uno 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 prima tabella codici che soddisfa le condizioni in dwEnumOption. 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.

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 FindFirstCodePage restituisce un handle utilizzato nelle chiamate a FindNextCodePage o FindCloseCodePage in caso di esito positivo. In caso di errore, INVALID_HANDLE_VALUE viene restituito per il valore di questo handle.

Commenti

L'handle restituito da questa funzione non deve essere manomesso dall'utente.

Questa funzione è supportata da SNANLS in Host Integration Server.