IAssocHandler：：IsRecommended 方法 (shobjidl_core.h)

  • 项目

指示应用程序是否注册为查询文件类型的建议处理程序。

语法

HRESULT IsRecommended();

返回值

类型： HRESULT

如果建议使用程序，则返回S_OK;否则，S_FALSE。

注解

将自己注册为特定文件类型的处理程序的应用程序可以指定它们是否是推荐的处理程序。 这不会影响应用程序在启动时的实际行为。 它只是作为提示提供给用户，以及 UI 可根据需要以编程方式利用的值。 例如，Shell 的“打开方法”对话框将条目分隔为“推荐的程序”和其他程序。

请注意，计划建议可能会随时间推移而变化。 当用户从“打开方式”对话框的“其他程序”中选择应用程序以打开特定文件类型时，会提供一个示例。 这可能会导致 Shell 将该应用程序“提升”为该文件类型的建议状态。 由于建议的状态可能会随时间而改变，因此应用程序不应缓存此值，而是在每次需要时对其进行查询。

如果使用 ASSOC_FILTER_RECOMMENDED 标志调用 SHAssocEnumHandlers ，则仅返回建议的处理程序。 如果使用了 ASSOC_FILTER_NONE 标志，则必须在每个 IAssocHandler 对象上调用 IAssocHandler：：IsRecommended 以确定是否推荐。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)