FindNextCodePage

La función FindNextCodePage de SNA National Language Support (SNANLS) busca la siguiente instancia de página de códigos que cumple la condición especificada en la llamada inicial a la función FindFirstCodePage y copia la información de la página de códigos en una estructura pasada como parámetro.

Sintaxis

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

Parámetros

hInfo
Parámetro proporcionado. Identificador asignado y devuelto mediante FindFirstCodePage.

pPage
Parámetro proporcionado y devuelto. Puntero a codePage de estructura donde se debe copiar la información de la página de códigos.

En una devolución correcta, la ubicación de memoria a la que apunta este parámetro se rellenará con la información de la página de códigos siguiente que cumpla las condiciones del parámetro dwEnumOption pasado a la función FindFirstCodePage .

Si se produce un error, no se realizarán cambios en la memoria a la que apunta este parámetro.

La estructura CodePage se define en SNANLS. El archivo de inclusión H es el siguiente:

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

Los miembros de esta estructura CodePage son los siguientes:

CodePageKey

Valor numérico que representa el índice en la matriz de estructuras codePage. Este valor se debe usar como un valor opaco, ya que service Packs puede cambiar arbitrariamente este valor cuando se admiten páginas de códigos adicionales.

CodePageID

Número de página de códigos NLS.

szFriendlyName

Nombre para mostrar de SNANLS para esta página de códigos. La cadena de caracteres termina en null.

Egroup

El grupo por el que se representa esta página de códigos. . Este valor puede ser una de las siguientes enumeraciones definidas en el archivo de inclusión SNANLS.h para los grupos de código:

ENUM_CP_EBCDIC

Esta página de códigos es miembro del grupo de páginas de códigos EBCDIC.

ENUM_CP_ANSI

Esta página de códigos es miembro del grupo de páginas de códigos ANSI.

ENUM_CP_ISO

Esta página de códigos es miembro del grupo de páginas de códigos ISO.

ENUM_CP_OEMPC

Esta página de códigos es miembro del grupo de páginas de códigos del EQUIPO OEM.

ENUM_CP_ISO

Esta página de códigos es miembro del grupo de páginas de códigos ISO.

ENUM_CP_ISO

Esta página de códigos es miembro del grupo de páginas de códigos ISO.

ENUM_CP_OEM PC

Esta página de códigos es miembro del grupo de páginas de códigos del EQUIPO OEM.

ENUM_CP_OPEN

Esta página de códigos es miembro del grupo de páginas de códigos de Open Systems.

ENUM_CP_UCS

Esta página de códigos es miembro del grupo de páginas de códigos UCS.

bAvailable

Valor booleano usado para indicar que esta página de códigos está instalada en el equipo. Un valor false para este miembro indica que el equipo no se consultará para determinar si está instalada esta página de códigos. Un valor de TRUE indica que está instalada la página de códigos.

bccsid

Marca usada para indicar el tipo de página de códigos. Esta marca puede ser una de las siguientes:

ENUM_CP_DBCS (0x08)

La página de códigos es para un juego de caracteres de doble byte.

ENUM_CP_MBCS (0x10)

La página de códigos es para un juego de caracteres de bytes mixto.

ENUM_CP_SBCS (0x20)

La página de códigos es para un juego de caracteres de un solo byte.

bEuro

Valor booleano utilizado para indicar si esta página de códigos admite el símbolo del euro. Si este valor es TRUE, se admite el símbolo del euro.

Valor devuelto

La función FindNextCodePage devuelve un valor de TRUE si se ejecuta correctamente. Si se produce un error, el valor devuelto es FALSE.

Comentarios

SNANLS admite esta función en Host Integration Server.