getpeername()

getpeername()
开放分类： 编程

简述：
  获取与套接口相连的端地址。

  #include

  int PASCAL FAR getpeername( SOCKET s, struct sockaddr FAR* name,
  int FAR* namelen);

  s：标识一已连接套接口的描述字。
  name：接收端地址的名字结构。
  namelen：一个指向名字结构的指针。

注释：
  getpeername()函数用于从端口s中获取与它捆绑的端口名，并把它存放在sockaddr类型的name结构中。它适用于数据报或流类套接口。

返回值：
  若无错误发生，getpeername()返回0。否则的话，返回SOCKET_ERROR，应用程序可通过WSAGetLastError()来获取相应的错误代码。

错误代码：
  WSANOTINITIALISED：在使用此API之前应首先成功地调用WSAStartup()。
  WSAENETDOWN：WINDOWS套接口实现检测到网络子系统失效。
  WSAEFAULT：namelen参数不够大。
  WSAEINPROGRESS：一个阻塞的WINDOWS套接口调用正在运行中。
  WSAENOTCONN 套接口未连接。
  WSAENOTSOCK：描述字不是一个套接口。

参见：
  bind(), socket(), getsockname().
 

()