SHAssocEnumHandlersForProtocolByApplication 函式 (shobjidl_core.h)

取得列舉介面,這個介面提供與指定通訊協定相關聯之處理程式的存取權。

語法

SHSTDAPI SHAssocEnumHandlersForProtocolByApplication(
  [in]  PCWSTR protocol,
  [in]  REFIID riid,
  [out] void   **enumHandlers
);

參數

[in] protocol

類型: PCWSTR

指定通訊協定的字串指標。

[in] riid

類型: REFIID

要透過 enumHandlers 擷取之介面 IID 的參考,通常IID_IEnumAssocHandlers。

[out] enumHandlers

類型: void**

當這個方法傳回時,會包含 riid中要求的介面指標。 這通常是 IEnumAssocHandlers

傳回值

類型: HRESULT

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

備註

建議您使用 Objbase.h 中定義的 IID_PPV_ARGS 宏來封裝 riidenumHandlers 參數。 這個宏會根據 enumHandlers 中值所指向的介面提供正確的 IID,這可消除編碼錯誤的可能性。

規格需求

需求
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限桌面應用程式]
目標平台 Windows
標頭 shobjidl_core.h (包含 Shobjidl.h)
程式庫 Shell32.lib
Dll Shell32.dll (6.1 版或更新版本)