SHAssocEnumHandlersForProtocolByApplication 函数 (shobjidl_core.h)
获取一个枚举接口,该接口提供对与给定协议关联的处理程序的访问。
语法
SHSTDAPI SHAssocEnumHandlersForProtocolByApplication(
[in] PCWSTR protocol,
[in] REFIID riid,
[out] void **enumHandlers
);
参数
[in] protocol
类型: PCWSTR
指向指定协议的字符串的指针。
[in] riid
类型: REFIID
对要通过 枚举进行检索的接口的 IID 的引用,通常IID_IEnumAssocHandlers。
[out] enumHandlers
类型: void**
此方法返回时,包含 riid 中请求的接口指针。 这通常是 IEnumAssocHandlers。
返回值
类型: HRESULT
如果此函数成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
注解
建议使用 objbase.h 中定义的 IID_PPV_ARGS 宏来打包 riid 和 enumHandlers 参数。 此宏基于 枚举中值指向的接口提供正确的 IID,这消除了编码错误的可能性。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 7 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
目标平台 | Windows |
标头 | shobjidl_core.h (包括 Shobjidl.h) |
Library | Shell32.lib |
DLL | Shell32.dll (版本 6.1 或更高版本) |