Función EnumCalendarInfoA (winnls.h)

Artículo
11/20/2024

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

Nota Para recibir un identificador de calendario además de la información del calendario, la aplicación debe usar la función EnumCalendarInfoEx . Otra razón para preferir esta función es que Microsoft está migrando hacia el uso de nombres de configuración regional en lugar de identificadores de configuración regional por nuevas configuraciones regionales, por motivos de interoperabilidad.

Nota Cualquier aplicación que se ejecute solo en Windows Vista y versiones posteriores debe usar EnumCalendarInfoExex en preferencia a EnumCalendarInfo.

Sintaxis

BOOL EnumCalendarInfoA(
  [in] CALINFO_ENUMPROCA lpCalInfoEnumProc,
  [in] LCID              Locale,
  [in] CALID             Calendar,
  [in] CALTYPE           CalType
);

Parámetros

[in] lpCalInfoEnumProc

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

[in] Locale

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

[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.

Observaciones

Vea los comentarios de EnumCalendarInfoEx.

Nota

El encabezado winnls.h define EnumCalendarInfo 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 Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	winnls.h (incluya Windows.h)
biblioteca de	Kernel32.lib
DLL de	Kernel32.dll