IWSDDeviceProxy::GetAllMetadata 方法 (wsdclient.h)

检索此设备的所有元数据。

语法

HRESULT GetAllMetadata(
  [out] WSD_METADATA_SECTION_LIST **ppMetadata
);

参数

[out] ppMetadata

引用 WSD_METADATA_SECTION_LIST 结构,该结构指定与设备相关的所有元数据。 请勿释放此对象。

返回值

此方法可以返回其中一个值。

可能的返回值包括但不限于以下内容。

返回代码 说明
S_OK
方法已成功完成。
E_POINTER
ppMetadataNULL

注解

提供此方法以便可以访问扩展元数据。 最好使用专门为这些目的提供的方法获取制造商、服务主机和设备特定的元数据。

GetAllMetadata 不会导致设备代理从设备检索元数据。 相反, GetAllMetadata 将返回上次调用 BeginGetMetadata 和 EndGetMetadata 时检索到 元数据。 如果这两种方法均未调用, 则 GetAllMetadata 将返回初始化 IWSDDeviceProxy 对象时检索到的元数据。

成功后, ppMetadata 上的内存将有效,直到调用 BeginGetMetadataEndGetMetadata ,或者直到 释放 IWSDDeviceProxy 对象。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 wsdclient.h (包括 Wsdapi.h)
DLL Wsdapi.dll

另请参阅

IWSDDeviceProxy