IWSDDeviceProxy::GetAllMetadata 方法 (wsdclient.h)
检索此设备的所有元数据。
语法
HRESULT GetAllMetadata(
[out] WSD_METADATA_SECTION_LIST **ppMetadata
);
参数
[out] ppMetadata
引用 WSD_METADATA_SECTION_LIST 结构,该结构指定与设备相关的所有元数据。 请勿释放此对象。
返回值
此方法可以返回其中一个值。
可能的返回值包括但不限于以下内容。
返回代码 | 说明 |
---|---|
|
方法已成功完成。 |
|
ppMetadata 为 NULL。 |
注解
提供此方法以便可以访问扩展元数据。 最好使用专门为这些目的提供的方法获取制造商、服务主机和设备特定的元数据。
GetAllMetadata 不会导致设备代理从设备检索元数据。 相反, GetAllMetadata 将返回上次调用 BeginGetMetadata 和 EndGetMetadata 时检索到 的元数据。 如果这两种方法均未调用, 则 GetAllMetadata 将返回初始化 IWSDDeviceProxy 对象时检索到的元数据。
成功后, ppMetadata 上的内存将有效,直到调用 BeginGetMetadata 或 EndGetMetadata ,或者直到 释放 IWSDDeviceProxy 对象。
要求
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | wsdclient.h (包括 Wsdapi.h) |
DLL | Wsdapi.dll |