WSAUnadvertiseProvider 函数 (ws2spi.h)

项目
03/04/2024

WSAUnadvertiseProvider 函数使特定的命名空间版本 2 提供程序不再可供客户端使用。

语法

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

参数

[in] puuidProviderId

指向命名空间提供程序的提供程序 ID 的指针。

返回值

如果未发生错误， 则 WSAUnadvertiseProvider 返回零。否则，它将返回 SOCKET_ERROR，并且可通过调用 WSAGetLastError 获取特定的错误代码。

错误代码	含义
WSAEINVAL	参数无效。如果 puuidProviderId 参数为 NULL，则返回此错误。

注解

WSAUnadvertiseProvider 函数用作命名空间服务提供程序版本 2 的一部分， (Windows Vista 及更高版本上提供的 NSPv2) 体系结构。

在 Windows Vista 和 Windows Server 2008 上， WSAUnadvertiseProvider 函数只能用于对NS_EMAIL命名空间提供程序进行操作。

通常，NSPv2 提供程序是在调用应用程序以外的进程中实现的。由于客户端活动，NSPv2 提供程序未激活。每个托管应用程序的提供程序通过调用 WSAAdvertiseProvider 和 WSAUnadvertiseProvider 函数来决定何时使特定提供程序可用或不可用。客户端活动仅导致尝试联系提供程序（如果可用 () 播发命名空间提供程序时）。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	ws2spi.h
Library	Ws2_32.lib
DLL	Ws2_32.dll