getpeername
getpeername 함수는 소켓이 연결되어 있는 원격지 상대방(peer)의 이름(인터페이스 어드레스와 포트번호)을 얻는 함수입니다.
int getpeername (
SOCKET s,
struct sockaddr FAR* name,
int FAR* namelen
);
Parameters
s
[입력]
사용할 접속된 소켓의 기술자(descriptor)
name
[출력]
원격지 상대방(peer)의 이름을 받을 SOCKADDR
구조체의 포인터
namelen
[입/출력]
입력시에는 name
에 대한 버퍼 포인터의 최대 크기를 나타내고, 출력할 때는 실제로 사용된 버퍼 공간량을
나타내는 정수에 대한 포인터입니다.
Remarks
getpeername 함수는 소켓으로 접속되어 있는 원격지 상대방(peer)의 이름을 name 매개변수인 SOCKADDR 구조체로 반환 합니다. getpeername 함수는 접속된 소켓에 대해서만 사용할 수 있습니다. 데이터 그램 소켓에 대해서는 이전에 connect 함수를 호출했을 경우에만, 원격지 상대방(peer)의 이름(name)을 얻을 수 있습니다. - sendto 함수의 호출에 의해서는 getpeername 함수에 의해서 이름을 얻지는 못할 것입니다.
호출할 때 입력으로, namelen 매개변수는 name 매개변수의 버퍼 사이즈를 명시하고, 함수를 반환 할 때 namelen 매개변수는 실제로 사용된 버퍼 공간량을 나타내는 정수를 포인트 합니다. 일반적으로 프로그램은 getpeername 함수를 호출하기 전에 정수를 sizeof(SOCKADDR) 로 설정한 다음에 반환 값을 무시합니다.
Return Values
에러가 발생하지 않았을 때, getpeername 함수는 0을 반환합니다. 에러가 발생한 경우에는 SOCKET_ERROR을 반환 하고, WSAGetLastError 함수에 의해서 지정된 에러 코드를 검색할 수 있습니다.
Error Codes
| WSANOTINITIALISED | 이 함수를 사용하기 전에 성공적인 WSAStartup 함수의 호출이 없었습니다. |
| WSAENETDOWN | 네트웍 서브 시스템에 에러가 발생했습니다. |
| WSAEFAULT | name 또는 namelen 매개변수가 올바른 형태가 아닙니다. |
| WSAEINPROGRESS | 블럭킹 윈속 v1.1 이 현재 진행 중이거나, 서비스 프로바이더가 콜백 함수를 여전히 처리하고 있습니다. |
| WSAENOTCONN | s 매개변수로 적용하려는 소켓이 접속된 상태가 아닙니다. |
| WSAENOTSOCK | 기술자(descriptor)가 소켓 기술자가 아닙니다. |
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