LPNSPLOOKUPSERVICEEND 回调函数 (ws2spi.h)

调用 NSPLookupServiceEnd 函数以在以前调用 NSPLookupServiceBeginNSPLookupServiceNext 后释放句柄。

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

语法

LPNSPLOOKUPSERVICEEND Lpnsplookupserviceend;

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

参数

[in] hLookup

以前通过调用 获取的句柄
NSPLookupServiceBegin

返回值

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

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

注解

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

要求

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

另请参阅

NSPLookupServiceBegin

NSPLookupServiceNext

NSP_ROUTINE

WSASetLastError