通过

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