Share via

WPUQuerySocketHandleContext 函数 (ws2spi.h)

  • 项目

WPUQuerySocketHandleContext 函数查询与指定套接字句柄关联的上下文值。

语法

int WPUQuerySocketHandleContext(
  [in]  SOCKET     s,
  [out] PDWORD_PTR lpContext,
  [out] LPINT      lpErrno
);

参数

[in] s

用于标识要查询其上下文的套接字的说明。

[out] lpContext

将接收上下文值的指针。

[out] lpErrno

指向错误代码的指针。

返回值

如果未发生错误， 则 WPUQuerySocketHandleContext 返回零并将当前上下文值存储在 lpContext 中。 否则，它将返回SOCKET_ERROR，并且 lpErrno 中提供了特定的错误代码。

错误代码 含义
WSAENOTSOCK
 描述符不是 WPUCreateSocketHandle 创建的套接字。
 
 

注解

WPUQuerySocketHandleContext 函数查询与指定套接字句柄关联的当前上下文值。 服务提供程序通常使用此函数检索指向与套接字关联的特定于提供程序的数据的指针。 例如，服务提供商可以使用套接字上下文来存储指向结构的指针，该结构包含套接字的状态、本地和远程传输地址以及用于向网络事件发出信号的事件对象。

只有非 IFS 提供程序使用此函数，因为 IFS 提供程序无法提供上下文值。

要求

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

另请参阅

WPUCreateSocketHandle