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

Метод IWSDiscoveryPublisher::UnPublish (wsddisco.h)

  • Статья

Объявляет об уходе узла сети, отправляя сообщение Bye .

Синтаксис

HRESULT UnPublish(
  [in]           LPCWSTR              pszId,
  [in]           ULONGLONG            ullInstanceId,
  [in]           ULONGLONG            ullMessageNumber,
  [in, optional] LPCWSTR              pszSessionId,
  [in, optional] const WSDXML_ELEMENT *pAny
);

Параметры

[in] pszId

Логический или физический адрес устройства, который используется в качестве адреса конечной точки устройства. Логический адрес имеет вид urn:uuid:{guid}. Физический адрес может быть URI с префиксом http или https или просто URI с префиксом uri. По возможности используйте логический адрес.

[in] ullInstanceId

Идентификатор текущего экземпляра публикуемого устройства. Этот идентификатор должен увеличиваться при каждом перезапуске службы. Дополнительные сведения об идентификаторах экземпляров см. в приложении I к спецификации WS-Discovery.

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

[in] ullMessageNumber

Счетчик в область идентификатора экземпляра для текущего сообщения. Номер сообщения должен увеличиваться для каждого сообщения.

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

[in, optional] pszSessionId

Уникальный идентификатор в область идентификатора экземпляра для текущего сеанса. Этот параметр соответствует идентификатору последовательности в блоке AppSequence в сообщении пробы. Дополнительные сведения об идентификаторах последовательностей см. в приложении I к спецификации WS-Discovery.

Этот параметр может иметь значение NULL.

[in, optional] pAny

Указатель на WSDXML_ELEMENT структуру, содержащую XML-элемент, который необходимо вставить в раздел ANY текста сообщения.

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

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

Код возврата Описание
S_OK
 Метод завершился успешно.
E_INVALIDARG
 Выполняется одно или несколько из следующих условий:
  • PszId имеет значение NULL.
  • Длина pszId превышает WSD_MAX_TEXT_LENGTH (8192).
  • Длина pszSessionId превышает WSD_MAX_TEXT_LENGTH (8192).
E_ABORT
 Издатель не запущен. Присоединение приемника уведомлений запускает издателя. Чтобы подключить приемник, вызовите RegisterNotificationSink.
E_OUTOFMEMORY
 Недостаточно памяти для завершения операции.

Комментарии

В случае успешного выполнения отмена публикации отправит сообщение WS-Discovery Bye в локальную подсеть с предоставленными сведениями.

Требования

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

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

IWSDiscoveryPublisher