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 宏來封裝 riid 和 enumHandlers 參數。 這個宏會根據 enumHandlers 中值所指向的介面提供正確的 IID,這可消除編碼錯誤的可能性。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 R2 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | shobjidl_core.h (包含 Shobjidl.h) |
程式庫 | Shell32.lib |
Dll | Shell32.dll (6.1 版或更新版本) |