Поделиться через

Метод 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 этой структуры должны содержать непустые записи.

[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
Header wsdhost.h (включая Wsdapi.h)
DLL Wsdapi.dll

См. также раздел

IWSDDeviceHost