FindNextCodePage

La fonction FindNextCodePage de SNA National Language Support (SNANLS) recherche la instance suivante de la page de codes répondant à la condition spécifiée dans l’appel initial à la fonction FindFirstCodePage et copie les informations de la page de codes dans une structure passée en tant que paramètre.

Syntaxe

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

Paramètres

hInfo
Paramètre fourni. Handle alloué et retourné à l’aide de FindFirstCodePage.

pPage
Paramètre fourni et retourné. Pointeur vers struct CodePage où les informations de la page de codes doivent être copiées.

Lors d’un retour réussi, l’emplacement de mémoire pointé par ce paramètre est rempli avec les informations de la page de codes suivante répondant aux conditions du paramètre dwEnumOption passées à la fonction FindFirstCodePage .

En cas d’échec, aucune modification n’est apportée à la mémoire pointée par ce paramètre.

Le struct CodePage est défini dans le SNANLS. H include file comme suit :

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

Les membres de cette structure CodePage sont les suivants :

CodePageKey

Valeur numérique qui représente l’index dans le tableau de structures CodePage. Cette valeur doit être utilisée comme valeur opaque, car cette valeur peut être modifiée arbitrairement par les Service Packs lorsque des pages de codes supplémentaires sont prises en charge.

CodePageID

Numéro de page de codes NLS.

szFriendlyName

Nom complet SNANLS pour cette page de codes. La chaîne de caractères se termine par la valeur Null.

eGroup

Groupe par lequel cette page de codes est représentée. . Cette valeur peut être l’une des énumérations suivantes définies dans le fichier include SNANLS.h pour les groupes de code :

ENUM_CP_EBCDIC

Cette page de codes est membre du groupe de pages de codes EBCDIC.

ENUM_CP_ANSI

Cette page de codes est membre du groupe de pages de codes ANSI.

ENUM_CP_ISO

Cette page de codes est membre du groupe de pages de codes ISO.

ENUM_CP_OEMPC

Cette page de codes est membre du groupe de pages de codes de PC OEM.

ENUM_CP_ISO

Cette page de codes est membre du groupe de pages de codes ISO.

ENUM_CP_ISO

Cette page de codes est membre du groupe de pages de codes ISO.

ENUM_CP_OEM PC

Cette page de codes est membre du groupe de pages de codes de PC OEM.

ENUM_CP_OPEN

Cette page de codes est membre du groupe De pages de codes Open Systems.

ENUM_CP_UCS

Cette page de codes est membre du groupe de pages de codes UCS.

bDisponible

Valeur booléenne utilisée pour indiquer que cette page de codes est installée sur l’ordinateur. La valeur FALSE pour ce membre indique que l’ordinateur ne sera pas interrogé pour déterminer si cette page de codes est installée. La valeur TRUE indique que la page de codes est installée.

bccsid

Indicateur utilisé pour indiquer le type de page de codes. Cet indicateur peut être l’un des éléments suivants :

ENUM_CP_DBCS (0x08)

La page de codes est destinée à un jeu de caractères codés sur deux octets.

ENUM_CP_MBCS (0x10)

La page de codes est destinée à un jeu de caractères codés sur plusieurs octets.

ENUM_CP_SBCS (0x20)

La page de codes est destinée à un jeu de caractères codés sur un octet.

bEuro

Valeur booléenne utilisée pour indiquer si cette page de codes prend en charge le symbole euro. Si cette valeur est TRUE, le symbole euro est pris en charge.

Valeur renvoyée

La fonction FindNextCodePage retourne la valeur TRUE en cas de réussite. En cas d’échec, la valeur retournée est FALSE.

Remarques

Cette fonction est prise en charge par SNANLS sur Host Integration Server.