原文链接 -> 传送门
函数功能:
EnumCalendarInfoExEx 函数用于枚举由名称指定的区域设置的日历信息。
注意1:如果设计运行仅在 Windows Vista 上及更高版本,应用程序应调用此函数而不是 EnumCalendarInfo 函数或 EnumCalendarInfoEx 函数。
注意2:此函数可以枚举版本之间发生改变的数据,例如,由于自定义区域设置发生更改的数据。如果您的应用程序必须保存或传输数据,请参阅 Using Persistent Locale Data。
API 函数原型:
注释:_In_ 说明该参数是输入的,_opt_ 说明该参数是可选的。
BOOL EnumCalendarInfoExEx( _In_ CALINFO_ENUMPROCEXEX pCalInfoEnumProcExEx, _In_opt_ LPCWSTR lpLocaleName, _In_ CALID Calendar, _In_opt_ LPCWSTR lpReserved, _In_ CALTYPE CalType, _In_ LPARAM lParam );
参数解析:
|
参数 |
含义 |
|
pCalInfoEnumProcExEx |
1. 指向应用程序自定义的回调函数的指针 |
|
lpLocaleName |
指向一个区域设置名称的指针,或者下列预定义值之一: |
|
Calendar |
1. 指定为其请求信息的日历的日历标识符 |
|
lpReserved |
不使用,该参数值必须为 NULL |
|
CalType |
1. 日历信息的类型 |
|
lParam |
1. 要传递给回调函数的应用程序提供参数 |
返回值:
如果函数成功,返回一个非零值;否则返回 0。为了获得更多的错误信息,应用程序可以调用 GetLastError 函数,其可以返回下列错误代码之一:
- ERROR_INVALID_FLAGS。为标志提供的值不是有效的。
- ERROR_INVALID_PARAMETER。任何参数的值是无效的。
备注:
1. 此函数枚举所有适用的日历指定的区域设置,或为一个单一的请求日历,日历参数的值根据日历信息。通过调用指定的应用程序定义的回调函数,函数枚举日历信息。它传递给回调函数一个包含请求的日历信息的指针、 日历标识符和应用程序定义的参数,该参数对多线程应用程序是有用的。此过程继续直到 EnumCalendarInfoExEx 发现最后适用日历或回调函数返回 FALSE。
2. 从 Windows8 开始:如果您的应用程序从 Windows.Globalization 命名空间传递语言标记给函数,它首先必须通过调用 ResolveLocaleName 函数转换标记。
需求:
|
Minimum supported client |
Windows 2000 专业版 [仅桌面应用程序] |
|
Minimum supported server |
Windows 2000 服务器版 [仅桌面应用程序] |
|
Header |
Winnls.h (包含于 Windows.h) |
|
Library |
Kernel32.lib |
|
DLL |
Kernel32.dll |




