enumDateFormatsExEx 函式 (winnls.h)
列舉名稱所指定地區設定的長日期、簡短日期或年份/月格式。
注意 如果應用程式設計為只在 Windows Vista 和更新版本上執行，則應用程式應該以喜好設定呼叫此函式 給 EnumDateFormats 或 EnumDateFormatsEx 。
注意 此函式可以列舉版本之間變更的數據，例如，因為自定義地區設定。 如果您的應用程式必須保存或傳輸數據，請參閱 使用持續性地區設定數據。
語法
BOOL EnumDateFormatsExEx(
[in] DATEFMT_ENUMPROCEXEX lpDateFmtEnumProcExEx,
[in, optional] LPCWSTR lpLocaleName,
[in] DWORD dwFlags,
[in] LPARAM lParam
);
參數
[in] lpDateFmtEnumProcExEx
應用程式定義回呼函式的指標。 如需詳細資訊，請參閱 EnumDateFormatsProcExEx。
[in, optional] lpLocaleName
地區設定名稱的指標，或下列其中一個預先定義的值。
[in] dwFlags
指定日期格式的旗標。 應用程式可以提供下列其中一個值或 LOCALE_USE_CP_ACP 常數。
| 值 | 意義 |
|---|---|
|
使用簡短日期格式。 此值不能與任何其他旗標值搭配使用。 |
|
使用長日期格式。 此值不能與任何其他旗標值搭配使用。 |
|
使用年/月格式。 此值不能與任何其他旗標值搭配使用。 |
|
使用月/日格式。 此值不能與任何其他旗標值搭配使用。 |
[in] lParam
要傳遞至回呼函式的應用程式提供參數。 此值特別適用於多線程應用程式。
傳回值
如果成功，則傳回非零值，否則傳回 0。 若要取得延伸的錯誤資訊，應用程式可以呼叫 GetLastError，這可以傳回下列其中一個錯誤碼：
- ERROR_BADDB。 函式無法存取數據。 這種情況通常不應該發生，通常表示安裝不正確、磁碟問題或類似。
- ERROR_INVALID_FLAGS。 為旗標的值無效。
- ERROR_INVALID_PARAMETER。 任何參數值都無效。
備註
注意 此 API 即將更新，以支援 2019 年 5 月日紀元變更。 如果您的應用程式支援日曆，您應該驗證它是否能夠正確處理新紀元。 如需詳細資訊 ，請參閱準備您的應用程式以進行日文紀元變更 。
從 Windows 8 開始：如果您的 app 從 Windows.Globalization 命名空間將語言標記傳遞至此函式，則必須先呼叫 ResolveLocaleName 來轉換標記。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | winnls.h (包含 Windows.h) |
| 程式庫 | Kernel32.lib |
| DLL | Kernel32.dll |