Функция WSAUnadvertiseProvider (ws2spi.h)
Функция WSAUnadvertiseProvider делает конкретный поставщик пространства имен версии 2 недоступным для клиентов.
Синтаксис
INT WSAAPI WSAUnadvertiseProvider(
[in] const GUID *puuidProviderId
);
Параметры
[in] puuidProviderId
Указатель на идентификатор поставщика пространства имен.
Возвращаемое значение
Если ошибка не возникает, WSAUnadvertiseProvider возвращает ноль. В противном случае он возвращает SOCKET_ERROR, и конкретный код ошибки доступен путем вызова WSAGetLastError.
| Код ошибки | Значение |
|---|---|
| Недопустимый параметр. Эта ошибка возвращается, если параметр 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 |