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