Функция WSAUnadvertiseProvider (ws2spi.h)

  • Статья

Функция WSAUnadvertiseProvider делает конкретный поставщик пространства имен версии 2 недоступным для клиентов.

Синтаксис

INT WSAAPI WSAUnadvertiseProvider(
  [in] const GUID *puuidProviderId
);

Параметры

[in] puuidProviderId

Указатель на идентификатор поставщика пространства имен.

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

Если ошибка не возникает, WSAUnadvertiseProvider возвращает ноль. В противном случае он возвращает SOCKET_ERROR, и конкретный код ошибки доступен путем вызова WSAGetLastError.

Код ошибки Значение
WSAEINVAL
 Недопустимый параметр. Эта ошибка возвращается, если параметр puuidProviderId имеет значение **NULL**.

Комментарии

Функция WSAUnadvertiseProvider используется как часть архитектуры поставщика службы пространства имен версии 2 (NSPv2), доступной в Windows Vista и более поздних версий.

В Windows Vista и Windows Server 2008 функцию WSAUnadvertiseProvider можно использовать только для операций с поставщиками NS_EMAIL пространств имен.

Как правило, поставщики NSPv2 реализуются в процессах, отличных от вызывающих приложений. Поставщики NSPv2 не активируются в результате действий клиента. Каждое приложение поставщика, размещающее поставщик, решает, когда следует сделать конкретный поставщик доступным или недоступным, путем вызова функций WSAAdvertiseProvider и WSAUnadvertiseProvider . Действие клиента приводит к попыткам связаться с поставщиком только при наличии (при объявлении поставщика пространства имен).

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header ws2spi.h
Библиотека Ws2_32.lib
DLL Ws2_32.dll

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

NSPV2_ROUTINE

WSAAdvertiseProvider

WSAEnumNameSpaceProviders

WSAEnumNameSpaceProvidersEx

WSASetService