NSPStartup 函数 (ws2spi.h)

NSPStartup 函数检索有关提供程序的动态信息,例如 DLL 入口点的列表。

此函数在初始化时由客户端调用。 NSPStartupNSPCleanup 函数必须作为对调用。 必须从 NSPStartup/NSPCleanup 对中调用所有 NSP 函数。 不需要从 NSPStartup/NSPCleanup 对中调用 WSC 函数。

语法

INT WSAAPI NSPStartup(
  [in]  LPGUID        lpProviderId,
  [out] LPNSP_ROUTINE lpnspRoutines
);

参数

[in] lpProviderId

从中返回入口点的所需提供程序。

[out] lpnspRoutines

指向 NSP_ROUTINE 结构的指针,如果函数调用成功,则指向提供程序入口点。

返回值

如果例程成功 函数应返回NO_ERROR (零) 。 如果函数失败,它应返回 SOCKET_ERROR (-1) ,并且必须使用 WSASetLastError 设置相应的错误代码。

说明
WSA_NOT_ENOUGH_MEMORY
没有足够的内存可用于执行此操作。
WSAEINVAL
此提供程序的一个或多个参数无效或缺失。
WSAEINVALIDPROCTABLE
过程调用表无效。
WSAEOPNOTSUPP
此操作不受支持。 如果命名空间提供程序未实现此函数,则返回此错误。
WSASYSNOTREADY
NSPStartup 函数目前无法运行,因为它用于提供网络服务的基础系统当前不可用。

注解

有关详细信息,请参阅 NSP_ROUTINE 结构。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 ws2spi.h

另请参阅

NSPCleanup

NSP_ROUTINE

WSASetLastError