enumTimeFormatsA 函式 (winnls.h)
列舉標識碼所指定地區設定可用的時間格式。
語法
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。 任何參數值都無效。
備註
函式會藉由將包含時間格式的緩衝區指標傳遞至應用程式定義的回呼函式,以列舉時間格式。 列舉中的第一個值一律是用戶預設 (覆寫) 值。 函式會繼續列舉,直到找到最後一次格式,否則回呼函式會傳回 FALSE。
此函式可以從 自定義地區設定列舉數據。 數據不保證從計算機到計算機或在應用程式執行之間相同。 如果您的應用程式必須保存或傳輸數據,請參閱 使用持續性地區設定數據。
當此函式的 ANSI 版本搭配僅限 Unicode 的地區設定識別碼使用時,呼叫可能會成功,因為系統會使用系統代碼頁。 不過,系統代碼頁中未定義的字元會出現在字串中,以問號 (“?) 。 請注意,未來引進 之 dwFlags 的任何新值都不適用於 ANSI 版本。
注意
winnls.h 標頭會將 EnumTimeFormats 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | winnls.h (包含 Windows.h) |
程式庫 | Kernel32.lib |
DLL | Kernel32.dll |