SHAssocEnumHandlers 函式 (shobjidl_core.h)

傳回指定之擴展名處理程式集的列舉物件。

語法

SHSTDAPI SHAssocEnumHandlers(
  [in]  PCWSTR             pszExtra,
  [in]  ASSOC_FILTER       afFilter,
  [out] IEnumAssocHandlers **ppEnumHandler
);

[in] pszExtra

類型： PCWSTR

包含單一檔類型擴展名的 Null 終止緩衝區指標，例如「.jpg」。。只會列舉與指定延伸模組相關聯的處理程式。此參數可能不是 NULL。

[in] afFilter

類型： ASSOC_FILTER

指定套用至 pszExtra 中所指定值之處理程式完整清單的列舉處理程式篩選。下列其中一個值。

值	Description
ASSOC_FILTER_NONE	傳回所有處理程式。
ASSOC_FILTER_RECOMMENDED	只傳回建議的處理程式。處理程式會在安裝時，在登錄中設定其建議狀態。非建議的初始狀態稍後可以升級為建議，因為用戶動作。

[out] ppEnumHandler

當這個方法傳回時，會包含 IEnumAssocHandlers 物件的指標位址。

類型： HRESULT

如果此函式成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。