Función EnumCalendarInfoExA (winnls.h)
Enumera la información del calendario de una configuración regional especificada por identificador.
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 la información del calendario. Puede usar la macro MAKELCID
[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
Esta función enumera la información del calendario para 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 del 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 de 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 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 |
Consulte también
información de tipo de calendario
enumCalendarInfo de