listen
listen 함수는 외부로부터 들어오는 접속을 감지하기 위해 특정 소켓이 사용될 것임을 윈도우즈 소켓에게 알리는 함수입니다.
int listen (
SOCKET s,
int backlog
);
Parameters
s
[입력]
리슨 하기위해 사용될 소켓의 기술자(descriptor)를 명시합니다.
backlog
[입력]
대기하는 접속을 위한 큐의 최대 길이를 명시합니다. 이 값이 SOMAXCONN 일 경우,
기본 서비스 프로바이더가 적절한 최대 큐의 길이를 설정하는 일을 담당하게 됩니다.
Remarks
접속을 허용하기 위해서 소켓은 우선 socket 함수를 이용해서 소켓을 생성합니다. 그런다음 bind 함수를 이용해서 로컬 어드레스를 바인드하죠. 마지막으로 accept 함수로 접속을 허용합니다. 들어오는 접속요청을 임시저장 하기 위한 큐의 길이는 listen 함수의 backlog 매개변수에 의해서 명시됩니다. listen 함수는 접속 지향형(connection oriented)소켓(예:SOCK_STREAM) 의 경우에만 사용된다는 점 명심합시다.
일반적으로 listen 함수는 한번에 하나 이상의 접속 요구를 가질 수 있는 서버에 사용됩니다. 만약 접속요청이 들어오고, 큐가 가득 차있으면, 프로그램은 WSAECONNREFUSED 라는 에러코드를 일으키며 실패를 할 것입니다.
어플리케이션은 같은 소켓에 대해서 한번이상의 listen 함수를 호출 할 수 있습니다. 이렇게 함으로써 리슨 소켓에 대한 현재의 큐의 최대크기(backlog)를 업데이트 할 수 있습니다. 새로 설정된 큐의 크기보다 더 많은 접속을 하려고 하는 요구가 있을 경우 초과되는 접속요청은 리셋되고, 버려집니다.
Compatibility
backlog 매개변수는 기본 서비스 프로바이더에 의해서 결정되는 적절한 값으로 제한됩니다. 범위를 넘어서거나 잘못된 값을 설정하는 경우 서비스 프로바이더는 적절한 가장 가까운 값으로 이 값을 대체시킵니다. 사실상 실제적인 backlog 값을 알아 낼 수 있는 표준 규정 같은건 없습니다. 그저 일반적으로 SOMAXCONN으로 설정하는 방법이 일반적입니다.
Return Values
에러가 발생하지 않은 경우 listen 함수는 0을 반환 합니다. 에러가 발생한 경우는 SOCKET_ERROR를 반환하고 WSAGetLastError 함수를 이용해서 특정 에러코드를 얻어낼 수 있습니다.
Error Codes
| WSANOTINITIALISED | 이 함수를 사용하기 전에 성공적인 WSAStartup 함수의 호출이 없었습니다. |
| WSAENETDOWN | 네트웍 서브 시스템에 에러가 발생했습니다. |
| WSAEADDRINUSE | 소켓이 SO_REUSEADDR 옵션으로 마크되어 있지 않은 상태에서 소켓의 로컬 주소가 이미 사용 중입니다. |
| WSAEINPROGRESS | 블럭킹 윈속 v1.1 이 현재 진행 중이거나, 서비스 프로바이더가 콜백 함수를 여전히 처리하고 있습니다. |
| WSAEINVAL | 소켓이 bind 함수를 사용하여 바인드 되지 않았습니다. |
| WSAEISCONN | 리슨소켓으로 사용하려고 하는 소켓이 접속된 상태의 소켓입니다. |
| WSAEMFILE | 사용가능한 소켓 기술자(descriptor)가 남아있지 않습니다. |
| WSAENOBUFS | 사용가능한 버퍼 공간이 남아있지 않습니다. |
| WSAENOTSOCK | 기술자(descriptor)가 소켓 기술자가 아닙니다. |
| WSAEOPNOTSUPP | socket s 매개변수로 넘긴 소켓이 리슨 연산을 지원하기에 적절한 형태의 소켓이 아닙니다. |
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
See Also