Share via

iWSDDeviceHost：：SetMetadata 方法 (wsdhost.h)

  • 發行項

設定裝置的元數據，不包括使用者定義的服務元數據。

語法

HRESULT SetMetadata(
  [in]           const WSD_THIS_MODEL_METADATA   *pThisModelMetadata,
  [in]           const WSD_THIS_DEVICE_METADATA  *pThisDeviceMetadata,
  [in, optional] const WSD_HOST_METADATA         *pHostMetadata,
  [in, optional] const WSD_METADATA_SECTION_LIST *pCustomMetadata
);

參數

[in] pThisModelMetadata

WSD_THIS_MODEL_METADATA 結構的參考，指定此裝置模型所有實例通用的元數據。 結構的 Manufacturer、 ModelNames 和 ModelNumber 成員必須包含非 NULL、非空白的專案。

[in] pThisDeviceMetadata

指定此裝置唯一之元數據 的WSD_THIS_DEVICE_METADATA 結構的參考。 這個結構的 FriendlyName、FirmwareVersion 和 SerialNumber 成員必須包含非 NULL、非空白專案。

[in, optional] pHostMetadata

指定服務主機元數據 之WSD_HOST_METADATA 結構的參考，例如， (印表機支援色彩或具有裝訂器.) 等裝置的特定數據和特性。

[in, optional] pCustomMetadata

WSD_METADATA_SECTION_LIST結構的參考，這個結構會指定與此裝置相關聯的其他自定義元數據。

傳回值

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

傳回碼 描述
S_OK
 方法已順利完成。
E_INVALIDARG
 pThisDeviceMetadata 為 NULL、 pThisModelMetadata 為 NULL，或任一結構不包含必要的成員。 如需必要成員的清單，請參閱參數描述。
E_OUTOFMEMORY
 記憶體不足，無法完成作業。

備註

在啟動任何向 RegisterService 註冊的裝置主機之前，至少必須呼叫這個方法一次。 在裝置啟動更新元數據之後，可能會呼叫它，在此情況下，會發出 WS-Discovery Hello 訊息，指出新的元數據版本。

注意 尚未實作更新功能。
 

規格需求

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

另請參閱

IWSDDeviceHost