FindNextCodePage

La funzione SNA National Language Support (SNANLS) FindNextCodePage trova l'istanza successiva della tabella codici che soddisfa la condizione specificata nella chiamata iniziale alla funzione FindFirstCodePage e copia le informazioni della tabella codici in una struttura passata come parametro.

Sintassi

  
BOOL WINAPI FindNextCodePage(   
        const HANDLE hInfo  
struct CodePage *pPage  
);  

Parametri

hInfo
Parametro fornito. Handle allocato e restituito usando FindFirstCodePage.

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

In un ritorno restituito correttamente, il percorso di memoria a cui punta questo parametro verrà riempito con le informazioni per la tabella codici successiva che soddisfa le condizioni nel parametro dwEnumOption passato alla funzione FindFirstCodePage .

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 indicato di seguito:

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 pagine di codice.

CodePageID

Numero di 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 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 codici EBCDIC.

ENUM_CP_ANSI

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

ENUM_CP_ISO

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

ENUM_CP_OEMPC

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

ENUM_CP_ISO

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

ENUM_CP_ISO

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

ENUM_CP_OEM PC

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

ENUM_CP_OPEN

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

ENUM_CP_UCS

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

bAvailable

Valore booleano usato per indicare che questa tabella codici è installata nel computer. Un valore false per questo membro indica che il computer non verrà eseguito una query per determinare se questa tabella codici è installata. Valore true indicato che la tabella codici è installata.

bccsid

Flag usato 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 di 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 dell'euro. Se questo valore è TRUE, il simbolo euro è supportato.

Valore restituito

La funzione FindNextCodePage 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.