共用方式為


IWSDDeviceProxy::GetHostMetadata 方法 (wsdclient.h)

擷取裝置的類別特定元數據,描述裝置的功能及其裝載的服務。

語法

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

參數

[out] ppHostMetadata

指定元數據 之WSD_HOST_METADATA 結構的參考。 請勿釋放此物件。

傳回值

這個方法可以傳回其中一個值。

可能的傳回值包括,但不限於下列各項。

傳回碼 描述
S_OK
方法已順利完成。
E_POINTER
ppHostMetadataNULL

備註

GetHostMetadata 不會讓裝置 Proxy 從裝置擷取元數據。 相反地, GetHostMetadata 會傳回上次呼叫 BeginGetMetadataEndGetMetadata 所擷取的元數據。 如果這些方法都未呼叫, GetHostMetadata 會在初始化 IWSDDeviceProxy 物件時傳回擷取的元數據。

成功時, ppMetadata 的記憶體將會有效,直到 呼叫 BeginGetMetadataEndGetMetadata ,或直到 IWSDDeviceProxy 物件釋放為止。

規格需求

需求
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 wsdclient.h (包含 Wsdapi.h)
Dll Wsdapi.dll

另請參閱

IWSDDeviceProxy