getsockname
getsockname 함수는 지정된 소켓에 대한 로컬 이름(인터페이스 어드레스와 포트번호)을 얻어내는 함수입니다.
int getsockname (
SOCKET s,
struct sockaddr FAR* name,
int FAR* namelen
);
Parameters
s
[입력]
바인드된 소켓의 기술자(descriptor)
name
[출력]
로컬 이름을 받을 SOCKADDR
구조체의 포인터
namelen
[입/출력]
name
버퍼의 크기
Remarks
getsockname 함수는 name 매개변수에 지정된 소켓 기술자 에 대한 로컬 이름(name)을 반환합니다. 이 함수는 바인드 되었거나 접속된 소켓을 s 매개변수로 하여 사용되는 함수입니다. 이 함수는 처음에 bind 함수를 호출하지 않고 connect 함수를 호출하여 사용할 때 특히 유용합니다. getsockname 함수는 시스템에 셋팅된 로컬 이름을 결정하는 방법만을 제공합니다.
호출시에, namelen 매개변수는 name 버퍼의 크기를 포함한 값을 넘겨줍니다. 반환시에 namelen 매개변수는 name 매개변수의 실제적인 바이트 크기를 포함합니다.
getsockname 함수는 소켓이 connect 나 accept 함수로 연결된 것을 제외하고, 명시되지 않은 어드레스를 바인드 한 경우 호스트 어드레스에 대한 정보를 항상 반환 하지는 않습니다. 윈도우즈 소켓 어플리케이션은 소켓이 접속된 상태를 제외하고, 특정 어드레스가 명시되었다고 간주하지 말아야 합니다. 네트워크 인터페이스가 여러 가지인 호스트가 있을 수 있기 때문에 소켓이 사용하는 어드레스는 아직 알 수 없는 상태입니다. 만일 소켓이 비접속 프로토콜을 사용한다면, 어드레스는 소켓에서 입/출력이 발생할 때까지 사용 할 수 없을 것입니다.
Return Values
에러가 발생하지 않은 경우 0을 반환 합니다. 에러가 발생한 경우에는 SOCKET_ERROR 값이 반환 되며, WSAGetLastError 함수에 의해 특정한 에러코드를 얻어낼 수 있습니다.
Error Codes
| WSANOTINITIALISED | 이 함수를 사용하기 전에 성공적인 WSAStartup 함수의 호출이 없었습니다. |
| WSAENETDOWN | 네트웍 서브 시스템에 에러가 발생했습니다. |
| WSAEFAULT | name 또는 namelen 매개변수가 올바른 형태가 아닙니다. |
| WSAEINPROGRESS | 블럭킹 윈속 v1.1 이 현재 진행 중이거나, 서비스 프로바이더가 콜백 함수를 여전히 처리하고 있습니다. |
| WSAENOTSOCK | 기술자(descriptor)가 소켓 기술자가 아닙니다. |
| WSAEINVAL |
소켓이 bind 함수에 의해서 바인드 되지 않았거나, ADDR_ANY 가 바인드할 때 사용되었으나 접속은 아직 이루어지지 않은 상태 입니다. |
QuickInfo
Windows NT : 사용가능
Windows :
사용가능
Windows CE : 버젼 1.0 그리고 그이후의 버젼에서 사용가능
Header
:
Win16/32
: winsock.h
Win32-II
: winsock2.h
Import Library :
Win16 : winsock.lib
Win32
: wsock32.lib
Win32-II
: ws2_32.lib