LPNSPV2LOOKUPSERVICEEND回调函数 (ws2spi.h)

项目
03/04/2024

在以前调用 NSPv2LookupServiceBegin 和 NSPv2LookupServiceNextEx 后，调用 NSPv2LookupServiceEnd 函数以释放句柄。

语法

LPNSPV2LOOKUPSERVICEEND Lpnspv2lookupserviceend;

INT Lpnspv2lookupserviceend(
  [in] HANDLE hLookup
)
{...}

参数

[in] hLookup

以前通过调用获取的句柄
NSPv2LookupServiceBegin。

返回值

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

错误代码	含义
WSA_INVALID_HANDLE	句柄无效。
WSA_NOT_ENOUGH_MEMORY	没有足够的内存可用于执行此操作。

注解

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

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

在处理 NSPv2LookupServiceNextEx 时，可以在另一个线程上接收 NSPv2LookupServiceBegin 函数调用。这表示客户端已取消请求，提供程序应关闭句柄并从 NSPv2LookupServiceNextEx 函数调用返回，并将最后一个错误设置为 WSA_E_CANCELLED。

在 Windows 套接字 2 中，为 WSAECANCELLED 和 WSA_E_CANCELLED 定义冲突错误代码。错误代码 WSAECANCELLED 将在将来的版本中删除，并且仅保留WSA_E_CANCELLED。命名空间提供程序应使用WSA_E_CANCELLED错误代码来保持与最广泛的应用程序的兼容性。

要求

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