SHAssocEnumHandlers 函数 (shobjidl_core.h)

返回一组指定的文件扩展名处理程序的枚举对象。

语法

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

[in] pszExtra

类型： PCWSTR

指向包含单个文件类型扩展名（例如“.jpg”）的以 null 结尾的缓冲区的指针。仅枚举与给定扩展关联的处理程序。此参数不能为 NULL。

[in] afFilter

类型： ASSOC_FILTER

指定应用于 从 pszExtra 中给定的值产生的处理程序的完整列表的枚举处理程序筛选器。以下值之一。

“值”	说明
ASSOC_FILTER_NONE	返回所有处理程序。
ASSOC_FILTER_RECOMMENDED	仅返回建议的处理程序。处理程序在安装时在注册表中设置建议的状态。用户操作后，初始状态为“非建议”可提升为“建议”。

[out] ppEnumHandler

此方法返回时，包含指向 IEnumAssocHandlers 对象的指针的地址。

类型： HRESULT

如果此函数成功，则返回 S_OK。否则，将返回 HRESULT 错误代码。