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 或更高版本) |