请输入您要查询的百科知识:

 

词条 getsockname()
释义

§ 简述

获取一个套接口的本地名字。

#include <winsock.h>

int PASCAL FAR getsockname( SOCKET s, struct sockaddr FAR* name,

int FAR* namelen);

s:标识一个已捆绑套接口的描述字。

name:接收套接口的地址(名字)。

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()捆绑。

参见:

bind(), socket(), getpeername().

随便看

 

百科全书收录594082条中文百科知识,基本涵盖了大多数领域的百科知识,是一部内容开放、自由的电子版百科全书。

 

Copyright © 2004-2023 Cnenc.net All Rights Reserved
更新时间:2024/12/19 1:57:44