共用方式為


enumCalendarInfoExEx 函式 (winnls.h)

列舉名稱所指定地區設定的行事曆資訊。

注意 如果設計為只在 Windows Vista 和更新版本上執行,則應用程式應該依喜好呼叫此函式 以 EnumCalendarInfoEnumCalendarInfoEx

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

語法

BOOL EnumCalendarInfoExEx(
  [in]           CALINFO_ENUMPROCEXEX pCalInfoEnumProcExEx,
  [in, optional] LPCWSTR              lpLocaleName,
  [in]           CALID                Calendar,
  [in, optional] LPCWSTR              lpReserved,
  [in]           CALTYPE              CalType,
  [in]           LPARAM               lParam
);

參數

[in] pCalInfoEnumProcExEx

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

[in, optional] lpLocaleName

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

[in] Calendar

指定 要求資訊的行事曆標識碼。 請注意,此標識碼可以是ENUM_ALL_CALENDARS,以列舉與地區設定相關聯的所有行事曆。

[in, optional] lpReserved

保留;必須是 NULL

[in] CalType

行事曆信息的類型。 如需詳細資訊,請參閱 行事曆類型資訊。 每個呼叫此函式時只能指定一個行事曆類型,但未註明。

[in] lParam

要傳遞至回調函式的應用程式提供參數。 這個值對於多線程應用程式特別有用。

傳回值

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

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

備註

此函式會根據 Calendar 參數的值,列舉指定地區設定之所有適用行事曆的行事曆資訊,或針對單一要求的行事歷列舉行事 資訊。 函式會呼叫指定的應用程式定義回呼函式來列舉行事曆資訊。 它會將回呼函式的指標傳遞給緩衝區,其中包含要求的行事曆資訊、行事曆標識符,以及適用於多線程應用程式的應用程式定義參數。 此程式會繼續執行,直到 EnumCalendarInfoExEx 找到 最後一個適用的行事曆或回呼函式傳回 FALSE 為止。

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

規格需求

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

另請參閱

行事曆類型資訊

EnumCalendarInfo

EnumCalendarInfoEx

EnumCalendarInfoProcExEx

EnumDateFormatsExEx

國家語言支援

國家語言支援函式