Función EnumCalendarInfoExA (winnls.h)

Artículo
03/08/2023

Enumera la información del calendario de una configuración regional especificada por el identificador.

Nota Cualquier aplicación que se ejecute solo en Windows Vista y versiones posteriores debe usar EnumCalendarInfoExEx en preferencia para esta función.

Sintaxis

BOOL EnumCalendarInfoExA(
  [in] CALINFO_ENUMPROCEXA lpCalInfoEnumProcEx,
  [in] LCID                Locale,
  [in] CALID               Calendar,
  [in] CALTYPE             CalType
);

Parámetros

[in] lpCalInfoEnumProcEx

Puntero a una función de devolución de llamada definida por la aplicación. Para obtener más información, vea EnumCalendarInfoProcEx.

[in] Locale

Identificador de configuración regional que especifica la configuración regional para la que se va a recuperar información del calendario. Puede usar la macro MAKELCID para crear un identificador o usar uno de los siguientes valores predefinidos.

Windows Vista y versiones posteriores: También se admiten los siguientes identificadores de configuración regional personalizados.

[in] Calendar

Identificador de calendario que especifica el calendario para el que se solicita información. Tenga en cuenta que este identificador puede ser ENUM_ALL_CALENDARS, para enumerar todos los calendarios asociados a la configuración regional.

[in] CalType

Tipo de información del calendario. Para obtener más información, vea Información de tipo de calendario. Solo se puede especificar un tipo de calendario por llamada a esta función, excepto cuando se indique.

Valor devuelto

Devuelve un valor distinto de cero si se ejecuta correctamente 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_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 la información del calendario de todos los calendarios aplicables para la configuración regional especificada o para un único calendario solicitado, en función del valor del parámetro Calendar . La función enumera la información del calendario llamando a la función de devolución de llamada definida por la aplicación especificada. Pasa la función de devolución de llamada un puntero a un búfer que contiene la información de calendario solicitada. Este proceso continúa hasta que EnumCalendarInfoEx encuentra el último calendario aplicable o la función de devolución de llamada devuelve FALSE.

Esta función puede enumerar datos de configuraciones regionales personalizadas. No se garantiza que los datos sean los mismos desde el equipo al equipo o entre ejecuciones de una aplicación. Si la aplicación debe conservar o transmitir datos, consulte Uso de datos de configuración regional persistente.

Cuando se usa la versión ANSI de esta función con un identificador de configuración regional solo Unicode, la función puede realizarse correctamente porque el sistema operativo usa la página de códigos del sistema. Sin embargo, los caracteres que no están definidos en la página de códigos del sistema aparecen en la cadena como signo de interrogación (?).

Nota:

El encabezado winnls.h define EnumCalendarInfoEx 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winnls.h (incluya Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll