Función EnumSystemCodePagesA (winnls.h)

  • Artículo

Enumera las páginas de códigos instaladas o compatibles con un sistema operativo.

Sintaxis

BOOL EnumSystemCodePagesA(
  [in] CODEPAGE_ENUMPROCA lpCodePageEnumProc,
  [in] DWORD              dwFlags
);

Parámetros

[in] lpCodePageEnumProc

Puntero a una función de devolución de llamada definida por la aplicación. La función EnumSystemCodePages enumera las páginas de códigos realizando llamadas repetidas a esta función de devolución de llamada. Para obtener más información, vea EnumCodePagesProc.

[in] dwFlags

Marca que especifica las páginas de códigos que se van a enumerar. Este parámetro puede tener uno de los valores siguientes, que son mutuamente excluyentes.

Valor Significado
CP_INSTALLED
 Enumerar solo las páginas de códigos instaladas.
CP_SUPPORTED
 Enumera todas las páginas de códigos admitidas.

Valor devuelto

Devuelve un valor distinto de cero si es correcto o 0 de lo contrario. Para obtener información de error extendida, la aplicación puede llamar a GetLastError, que puede devolver uno de los siguientes códigos de error:

  • ERROR_BADDB. La función no pudo acceder a los datos. Esta situación no debería producirse normalmente y normalmente indica una instalación incorrecta, un problema de disco o similar.
  • ERROR_INVALID_FLAGS. Los valores proporcionados para las marcas no eran válidos.
  • ERROR_INVALID_PARAMETER. Cualquiera de los valores de parámetro no era válido.

Comentarios

Esta función enumera las páginas de códigos pasando identificadores de página de códigos, de uno en uno, a la función de devolución de llamada definida por la aplicación especificada. Este proceso continúa hasta que todos los identificadores de página de códigos instalados o admitidos se hayan pasado a la función de devolución de llamada o la función de devolución de llamada devuelva FALSE.

Cuando una aplicación usa esta función para determinar una página de códigos adecuada para guardar datos, debe usar Unicode siempre que sea posible. Otras páginas de códigos no son tan portátiles como Unicode entre proveedores o sistemas operativos, debido a diferentes implementaciones de los estándares asociados.

Nota

El encabezado winnls.h define EnumSystemCodePages como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado winnls.h (incluye Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

EnumCodePagesProc

Compatibilidad con idiomas nacionales

Funciones de compatibilidad con idiomas nacionales