Share via

LPWSPGETPEERNAME 回调函数 (ws2spi.h)

  • 项目

LPWSPGetPeerName 函数获取套接字连接到的对等方的地址。

语法

LPWSPGETPEERNAME Lpwspgetpeername;

int Lpwspgetpeername(
  [in]      SOCKET s,
  [out]     sockaddr *name,
  [in, out] LPINT namelen,
  [out]     LPINT lpErrno
)
{...}

参数

[in] s

标识连接的套接字的描述符。

[out] name

指向 sockaddr 结构的指针，用于接收对等方的名称。

[in, out] namelen

输入时，指向一个整数的指针，该整数指示 按名称指向的结构的大小（以字节为单位）。 在输出中，指示返回的名称的大小（以字节为单位）。

[out] lpErrno

指向错误代码的指针。

返回值

如果未发生错误， LPWSPGetPeerName 将返回零。 否则，返回值 SOCKET_ERROR，并在 lpErrno 中提供特定的错误代码。

错误代码 含义
WSAENETDOWN
 网络子系统失败。
WSAEFAULT
 name 或 namelen 参数不是用户地址空间的有效部分，或者 namelen 参数太小。
WSAEINPROGRESS
 当回调正在进行时，将调用函数。
WSAENOTSOCK
 ：描述符不是套接字。
WSAENOTCONN
 套接字未连接。
WSAENOTSOCK
 ：描述符不是套接字。

注解

LPWSPGetPeerName 函数提供连接到套接字 的对等方的名称，并将其存储在按名称引用的结构 sockaddr 中。 它只能在连接的套接字上使用。 对于数据报套接字，将仅返回上一个 LPWSPConnect 调用中指定的对等名称，LPWSPGetPeerName 不会返回由以前的 LPWSPSendTo 调用指定的任何名称。

返回时， namelen 参数包含返回的名称的实际大小（以字节为单位）。

要求

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

另请参阅

LPWSPBind

LPWSPGetSockName

LPWSPSocket