EnumTimeFormatsA 函式 （winnls.h）
列舉標識碼所指定地區設定可用的時間格式。
Note 基於互操作性考慮，應用程式應該偏好使用 EnumTimeFormatsEx 函式來 EnumTimeFormats，因為Microsoft正移轉至使用地區設定名稱，而不是新地區設定的地區設定標識符。 只有在 Windows Vista 和更新版本上執行的任何應用程式都應該使用 EnumTimeFormatsEx。
語法
BOOL EnumTimeFormatsA(
[in] TIMEFMT_ENUMPROCA lpTimeFmtEnumProc,
[in] LCID Locale,
[in] DWORD dwFlags
);
參數
[in] lpTimeFmtEnumProc
應用程式定義回呼函式的指標。 如需詳細資訊，請參閱 EnumTimeFormatsProc。
[in] Locale
地區設定標識碼，指定要擷取時間格式資訊的地區設定。 您可以使用 MAKELCID 巨集來建立地區設定識別碼，或使用下列其中一個預先定義的值。
- LOCALE_CUSTOM_DEFAULT
- LOCALE_CUSTOM_UI_DEFAULT
- LOCALE_CUSTOM_UNSPECIFIED
- LOCALE_INVARIANT
- LOCALE_SYSTEM_DEFAULT
- LOCALE_USER_DEFAULT
[in] dwFlags
時間格式。 此參數可以指定下列任何值的組合。
傳回值
如果成功，則傳回非零值，否則傳回 0。 若要取得擴充的錯誤資訊，應用程式可以呼叫 getLastError
- ERROR_INVALID_FLAGS。 為旗標的值無效。
- ERROR_INVALID_PARAMETER。 任何參數值都無效。
言論
函式會藉由將包含時間格式的緩衝區指標傳遞至應用程式定義的回呼函式，以列舉時間格式。 列舉中的第一個值一律是用戶預設 （override） 值。 函式會繼續列舉，直到找到最後一次格式，或回呼函式傳回 FALSE。
此函式可以從 自定義地區設定列舉數據。 數據不保證會從計算機到計算機，或在應用程式執行之間相同。 如果您的應用程式必須儲存或傳輸資料，請參閱使用永續性地區設定資料 。
當此函式的 ANSI 版本與僅限 Unicode 的地區設定識別碼搭配使用時，呼叫可能會成功，因為系統使用系統代碼頁。 不過，系統代碼頁中未定義的字元會在字串中顯示為問號（“？”）。 請注意，未來引進 dwFlags 的任何新值都不適用於 ANSI 版本。
注意
winnls.h 標頭會根據 UNICODE 預處理器常數的定義，將 EnumTimeFormats 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| 標頭 | winnls.h （包括 Windows.h） |
| 連結庫 | Kernel32.lib |
| DLL | Kernel32.dll |