IWSDDeviceProxy::GetThisDeviceMetadata 方法 (wsdclient.h)

检索此设备的特定于设备的元数据。

语法

HRESULT GetThisDeviceMetadata(
  [out] WSD_THIS_DEVICE_METADATA **ppThisDeviceMetadata
);

参数

[out] ppThisDeviceMetadata

引用 WSD_THIS_DEVICE_METADATA 结构,该结构指定此设备的特定于设备的元数据。 请勿释放此对象。

返回值

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

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

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

注解

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

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

要求

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

另请参阅

IWSDDeviceProxy