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.