iQueryAssociations：：GetData 方法 (shlwapi.h)

从注册表中搜索并检索与文件或协议关联相关的二进制数据。

语法

HRESULT GetData(
  [in]                ASSOCF    flags,
  [in]                ASSOCDATA data,
  [in, optional]      LPCWSTR   pszExtra,
  [out, optional]     void      *pvOut,
  [in, out, optional] DWORD     *pcbOut
);

参数

[in] flags

类型： ASSOCF

可用于控制搜索的 ASSOCF 值。

[in] data

类型： ASSOCDATA

ASSOCDATA 值，该值指定要返回的数据类型。

[in, optional] pszExtra

类型： LPCWSTR

指向可选的以 null 结尾的 Unicode 字符串的指针，其中包含有关数据位置的信息。 它通常设置为 Shell 谓词，例如 open。 如果未使用此参数，请将此参数设置为 NULL 。

[out, optional] pvOut

类型： void*

指向一个值的指针，当此方法成功返回时，该值将接收请求的数据值。

[in, out, optional] pcbOut

类型： DWORD*

指向一个值的指针，当调用此方法时，该值保存 pvOut 的大小（以字节为单位）。 当此方法成功返回时，该值包含实际检索到的数据的大小。

返回值

类型： HRESULT

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

要求

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

另请参阅

IQueryAssociations