FindFirstCodePage

La función FindFirstCodePage (SNA National Language Support) de SNA busca la primera instancia de una página de códigos que cumple la condición especificada, copia la información de la página de códigos en una estructura que se pasa como parámetro y abre y devuelve un identificador usado en llamadas posteriores a la función FindNextCodePage .

Sintaxis

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

Parámetros

dwEnumOption
Parámetro proporcionado. Conjunto de condiciones que debe cumplir una página de códigos. Estas condiciones pueden ser cualquier combinación de los siguientes valores definidos en el archivo de inclusión SNANLS.h:

ENUM_CP_AVAILABLE (0x01)

La página de códigos está instalada y disponible para su uso.

ENUM_CP_HOST (0x02)

La página de códigos es una página de códigos de host (EBCDIC, por ejemplo).

ENUM_CP_EURO (0x04)

La página de códigos contiene compatibilidad con el carácter euro.

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.

Tenga en cuenta que algunas de estas combinaciones representan casos que no coincidirán con las páginas de códigos instaladas usadas por SNANLS.

pPage
Parámetro proporcionado y devuelto. Puntero a una estructura CodePage 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 primera página de códigos que cumpla las condiciones de dwEnumOption. En caso de 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.

eGroup

Grupo representado por 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 de 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 usado 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 FindFirstCodePage devuelve un identificador usado en las llamadas a FindNextCodePage o FindCloseCodePage correctamente. En caso de error, se devuelve INVALID_HANDLE_VALUE para el valor de este identificador.

Observaciones

El usuario no debe manipular el identificador devuelto por esta función.

SNANLS admite esta función en Host Integration Server.