IWSDDeviceProxy：：GetHostMetadata 方法 (wsdclient.h)

检索设备特定于类的元数据，描述设备及其承载的服务的功能。

语法

HRESULT GetHostMetadata(
  [out] WSD_HOST_METADATA **ppHostMetadata
);

参数

[out] ppHostMetadata

对指定元数据 的WSD_HOST_METADATA 结构的引用。 请勿释放此对象。

返回值

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

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

返回代码	说明
S_OK	方法已成功完成。
E_POINTER	ppHostMetadata 为 NULL。

注解

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

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

要求

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

另请参阅

IWSDDeviceProxy