Compartir a través de


Función EnumCalendarInfoExEx (winnls.h)

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

Vea también

Información de tipo de calendario

EnumCalendarInfo

EnumCalendarInfoEx

EnumCalendarInfoProcEx

EnumDateFormatsExEx

Compatibilidad con idiomas nacionales

Funciones de compatibilidad con idiomas nacionales