Función EnumCalendarInfoExEx (winnls.h)

Artículo
08/27/2023

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

Nota La aplicación debe llamar a esta función en preferencia a EnumCalendarInfo o EnumCalendarInfoEx si está diseñada para ejecutarse solo en Windows Vista y versiones posteriores.

Nota Esta función puede enumerar los datos que cambian entre versiones, por ejemplo, debido a una configuración regional personalizada. Si la aplicación debe conservar o transmitir datos, consulte Uso de datos de configuración regional persistente.

Sintaxis

BOOL EnumCalendarInfoExEx(
  [in]           CALINFO_ENUMPROCEXEX pCalInfoEnumProcExEx,
  [in, optional] LPCWSTR              lpLocaleName,
  [in]           CALID                Calendar,
  [in, optional] LPCWSTR              lpReserved,
  [in]           CALTYPE              CalType,
  [in]           LPARAM               lParam
);

Parámetros

[in] pCalInfoEnumProcExEx

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

[in, optional] lpLocaleName

Puntero a un nombre de configuración regional o 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, optional] lpReserved

Reservados; debe ser NULL.

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

[in] lParam

Parámetro proporcionado por la aplicación para pasar a la función de devolución de llamada. Este valor es especialmente útil para las aplicaciones multiproceso.

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, un identificador de calendario y un parámetro definido por la aplicación que resulta útil para las aplicaciones multiproceso. Este proceso continúa hasta que EnumCalendarInfoExEx encuentra el último calendario aplicable o la función de devolución de llamada devuelve FALSE.

A partir de Windows 8: si la aplicación pasa etiquetas de idioma a esta función desde el espacio de nombres Windows.Globalization, primero debe convertir las etiquetas llamando a ResolveLocaleName.

Requisitos

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