Share via

LPNSPCLEANUP 回调函数 (ws2spi.h)

  • 项目

NSPCleanup 函数终止特定 Windows 套接字命名空间服务提供程序的使用。

语法

LPNSPCLEANUP Lpnspcleanup;

INT Lpnspcleanup(
  [in] LPGUID lpProviderId
)
{...}

参数

[in] lpProviderId

指向要终止的命名空间提供程序的 GUID 的指针。

返回值

如果未发生错误，则 NSPCleanup 返回 值 NO_ERROR (零) 。 否则， 将返回SOCKET_ERROR (–1) ，并且提供程序必须使用 WSASetLastError 设置相应的错误代码。

错误代码 含义
WSA_NOT_ENOUGH_MEMORY 没有足够的内存可用于执行此操作。
WSAEINVAL lpProviderId 参数未指定有效的提供程序。
WSAEOPNOTSUPP 此操作不受支持。 如果命名空间提供程序未实现此函数，则返回此错误。

注解

当应用程序使用 Windows 套接字命名空间服务提供程序完成时，将调用 NSPCleanup 函数。 NSPCleanup 函数取消注册特定命名空间提供程序，并允许传输服务提供商释放命名空间提供程序分配的任何资源。

在使用任何命名空间提供程序之前，必须成功调用 NSPStartup 函数。 允许进行多个 NSPStartup 调用。 但是，对于每个 NSPStartup 调用，还必须发出相应的 NSPCleanup 调用。 只有服务提供商的最终 NSPCleanup 执行实际清理;前面的 调用递减服务提供程序中的内部引用计数。

在可以从内存中卸载命名空间服务提供程序 DLL 之前，此函数不应返回。

要求

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

另请参阅