EnumTimeFormatsEx 函式 (winnls.h)

列舉名稱所指定地區設定可用的時間格式。

注意 如果設計為只在 Windows Vista 和更新版本上執行，應用程式應該優先呼叫此函 式給 EnumTimeFormats 。

 

注意 此函式可以列舉版本之間變更的數據，例如，因為自定義地區設定。 如果您的應用程式必須保存或傳輸數據，請參閱 使用持續性地區設定數據。

 

語法

BOOL EnumTimeFormatsEx(
  [in]           TIMEFMT_ENUMPROCEX lpTimeFmtEnumProcEx,
  [in, optional] LPCWSTR            lpLocaleName,
  [in]           DWORD              dwFlags,
  [in]           LPARAM             lParam
);

參數

[in] lpTimeFmtEnumProcEx

應用程式定義回呼函式的指標。 如需詳細資訊，請參閱 EnumTimeFormatsProcEx。

[in, optional] lpLocaleName

地區設定名稱的指標，或下列其中一個預先定義的值。

• LOCALE_NAME_INVARIANT
• LOCALE_NAME_SYSTEM_DEFAULT
• LOCALE_NAME_USER_DEFAULT

[in] dwFlags

時間格式。 設定為 0 以使用目前使用者的長時間格式，或從 Windows 7) 開始TIME_NOSECONDS (使用简短时间格式。

[in] lParam

要傳遞至回呼函式的應用程式提供參數。 這特別適用於多線程應用程式。

傳回值

如果成功，則傳回非零值，否則傳回 0。 若要取得延伸的錯誤資訊，應用程式可以呼叫 GetLastError，這可以傳回下列其中一個錯誤碼：

• ERROR_INVALID_FLAGS。 為旗標的值無效。
• ERROR_INVALID_PARAMETER。 任何參數值都無效。

備註

此函式會藉由將時間格式字串指標一次傳遞至指定的應用程式定義回呼函式，以及適用於多線程應用程式的應用程式定義常數，來列舉時間格式。 列舉中的第一個值一律是用戶預設 (覆寫) 值。 函式會繼續列舉，直到找到最後一次格式，否則回呼函式會傳回 FALSE。

從 Windows 8 開始：如果您的 app 從 Windows.Globalization 命名空間將語言標記傳遞至此函式，則必須先呼叫 ResolveLocaleName 來轉換標記。

規格需求

需求	值
最低支援的用戶端	Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	winnls.h (包含 Windows.h)
程式庫	Kernel32.lib
DLL	Kernel32.dll

另請參閱

EnumTimeFormats

EnumTimeFormatsProcEx

國家語言支援

國家語言支援函式