GetCodePage

La función GetCodePage de SNA National Language Support (SNANLS) copia la información de la página de códigos identificada por una clave en una estructura que se pasa como parámetro.

Sintaxis

  
BOOL WINAPI GetCodePage(   
        Int nKey  
struct CodePage *pPage  
);  

Parámetros

nKey
Parámetro proporcionado. Clave numérica de una página de códigos. Este valor es un índice opaco en una matriz que contiene las páginas de códigos admitidas por SNANLS. Normalmente, este valor es el miembro CodePageKey de una estructura CodePage devuelta desde una llamada anterior a FindFirstCodePage o FindNextCodePage.

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 específica.

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 euro. Si este valor es TRUE, se admite el símbolo del euro.

Valor devuelto

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

Comentarios

SNANLS admite esta función en Host Integration Server.