Метод IWSDDeviceHost::Start (wsdhost.h)

Статья
08/28/2023

Запускает узел устройства и публикует узел устройства с помощью сообщения WS-Discovery Hello. Если в этот метод передается приемник уведомлений, то также регистрируется приемник уведомлений. После успешного вызова start узел устройства будет автоматически отвечать на сообщения пробы и разрешения.

Синтаксис

HRESULT Start(
  [in]           ULONGLONG            ullInstanceId,
  [in]           const WSD_URI_LIST   *pScopeList,
  [in, optional] IWSDDeviceHostNotify *pNotificationSink
);

Параметры

[in] ullInstanceId

Идентификатор экземпляра. Если идентификатор не указан, в качестве значения по умолчанию используется текущее значение экземпляра + 1.

Примечание Для совместимости со спецификацией WS-Discovery это значение должно быть меньше или равно UINT_MAX (4294967295).

[in] pScopeList

Область узла устройства. Если значение РАВНО NULL, области не связаны с узлом.

[in, optional] pNotificationSink

Ссылка на объект IWSDDeviceHostNotify , указывающий приемник уведомлений.

Возвращаемое значение

Возможные возвращаемые значения включают, помимо прочего, следующие:

Код возврата	Описание
S_OK	Метод успешно завершен.
S_FALSE	Узел устройства уже запущен.
E_FAIL	Сбой метода. Возможно, произошел сбой, так как узел не был инициализирован. Вызовите init для инициализации узла устройства.
E_ABORT	С узлом не связаны метаданные.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	wsdhost.h (включая Wsdapi.h)
DLL	Wsdapi.dll

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

IWSDDeviceHost

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