Compartir a través de


FindFirstCodePage

La función FindFirstCodePage (SNA National Language Support) de SNA busca la primera instancia de una página de códigos que cumpla la condición especificada, copia la información de la página de códigos en una estructura pasada 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 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 página de códigos 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 primera página de códigos que cumpla las condiciones de dwEnumOption. 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.

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 FindFirstCodePage devuelve un identificador usado en las llamadas a FindNextCodePage o FindCloseCodePage si se realiza correctamente. Si se produce un error, se devuelve INVALID_HANDLE_VALUE para el valor de este identificador.

Comentarios

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

SNANLS admite esta función en Host Integration Server.