getsockname() getpeername

getsockname

编辑本段简述

　　获取一个套接口的本地名字。　　#include <winsock.h>　　int PASCAL FAR getsockname( SOCKET s, struct sockaddr FAR* name,　　int FAR* namelen);　　s：标识一个已捆绑套接口的描述字。　　name：接收套接口的地址（名字）。　　namelen：名字缓冲区长度。

编辑本段注释

　　getsockname() 函数用于获取一个套接字的名字。它用于一个已捆绑或已连接套接字s，本地地址将被返回。本调用特别适用于如下情况：未调用 bind()就调用了 connect()，这时唯有getsockname()调用可以获知系统内定的本地地址。在返回时，namelen参数包含了名字的实际字节数。　　若一个套接字与INADDR_ANY捆绑，也就是说该套接字可以用任意主机的地址，此时除非调用connect()或accept()来连接，否则getsockname()将不会返回主机IP地址的任何信息。除非套接字被连接，WINDOWS套接字应用程序不应假设IP地址会从INADDR_ANY变成其他地址。这是因为对于多个主机环境下，除非套接字被连接，否则该套接字所用的IP地址是不可知的。

编辑本段返回值

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

编辑本段错误代码

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

*********************************************************************************************************************************************************

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

　　#include <winsock.h>　

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

　s：标识一已连接套接口的描述字。　　name：接收端地址的名字结构。　　namelen：返回名字结构的长度。　　

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

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

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