IQueryAssociations：：Init 方法 (shlwapi.h)

项目
03/02/2024

初始化 IQueryAssociations 接口，并将根密钥设置为相应的 ProgID。

语法

HRESULT Init(
  [in]           ASSOCF  flags,
  [in, optional] LPCWSTR pszAssoc,
  [in, optional] HKEY    hkProgid,
  [in, optional] HWND    hwnd
);

参数

[in] flags

类型： ASSOCF

指定如何初始化搜索的标志。它通常设置为零，但它也可以采用以下 ASSOCF 值之一。

[in, optional] pszAssoc

类型： LPCWSTR

用于确定根键的 Unicode 字符串。如果为 hkProgid 指定了值，请将此参数设置为 NULL。可以使用四种类型的字符串：

文件扩展名

文件扩展名，例如 .txt。

CLSID

采用标准“{GUID}”格式的 CLSID GUID。

ProgID

应用程序的 ProgID，例如Word。Document.8.

可执行文件名称

应用程序的 .exe 文件的名称。必须在标志中设置ASSOCF_OPEN_BYEXENAME标志。

[in, optional] hkProgid

类型： HKEY

用作根键的子项的 HKEY 值。搜索仅在此键下方显示。如果为 pwszAssoc 指定了值，请将此参数设置为 NULL。

[in, optional] hwnd

类型：HWND

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。否则，将返回 HRESULT 错误代码。

注解

此方法初始化接口，并且每次需要指定新的根密钥时，都会调用此方法。可以使用 pwszAssoc 指定标识根键的字符串，例如文件扩展名或其关联的 ProgID。还可以指定根键的 HKEY 值。然后，Init 将使用此信息在注册表中查找根键。对其他 IQueryAssociations 方法的后续调用将使用它作为起点，并在根键的子项中搜索信息。

要求

要求	值
最低受支持的客户端	Windows 2000 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	shlwapi.h
Library	Shlwapi.lib
DLL	Shell32.dll (5.0 或更高版本)

另请参阅

IQueryAssociations

通过