WSAAccept

WSAAccept

WSAAccept 함수는 조건함수(condition function)의 반환값에 기반을 두어 접속을 조건적으로 허용하는 함수입니다.

SOCKET WSAAccept (
        SOCKET   s,
        struct sockaddr FAR *   addr,
        LPINT   addrlen,
        LPCONDITIONPROC lpfnCondition,
        DWORD   dwCallbackData
);

Parameters

s
[입력] listen 함수를 호출해서 접속요청을 감지하기 위한 리슨소켓의 기술자

addr
[출력] 접속되는 대상에 대한 어드레스를 수신할 버퍼의 포인터 정확한 addr 매개변수의 형태는 소켓이 생성될 때 어드레스 집합(family)에 의해서 결정됩니다.

addrlen
[입력/출력] 어드레스를 얻어올 addr 의 길이를 가지고 있는 정수에 대한 포인터

lpfnCondition
[입력] 조건을 처리하는 프로시져에 대한 어드레스 포인터로써 어플리케이션은 호출자의 매개변수 정보를 바탕으로 하여 접속의 허용/해제를 결정하게될 조건함수를 제공하게 됩니다.

dwCallbackData
[입력] 콜백 데이터는 조건함수의 dwCallbackData 매개변수의 값으로 어플리케이션으로 전달됩니다. 이 매개변수는 윈도즈 소켓에 의해서 변환되지 않습니다.

Remarks

WSAAccept 함수는 소켓 s 에 접속을 위해 접속큐에 대기하고 있는 첫 번째 접속요청을 얻어내고, 지정된 조건함수에 맞은 접속요청을 체크하는 함수입니다. 만약 조건함수가 CF_ACCEP를 반환한다면, WSAAccept 함수는 새로운 소켓을 생성하고, 조건함수의 결과 매개변수 g 가 가리키는 소켓을 그룹핑하는 작업을 수행합니다. 새로 생성된 소켓은 WSAAsyncSelect 함수나 WSAEventSelect 함수로 비동기 이벤트가 등록된 소켓 s 와 같은 속성을 가지게 됩니다. 하지만, 리슨소켓의 그룹 아이디를 포함하지는 않습니다.

만약 조건 함수가 CF_REJECT를 반환한다면, WSAAccept 함수는 접속요청을 받아들이지 않게 됩니다. 조건함수는 WSAAccept 함수가 동작하는 쓰레드 상에서 수행되고, 가능한 빨리 그 결과를 반환 합니다. 만약 접속을 허용할 건지 아닌지 하는 판단을 바로 알아낼 수 없다면, 조건함수는 CF_DEFER 라고 하는 아직 결정이 나지 않았다 라는 값을 반환하게 됩니다. 이때 어떻한 액션도 일어나지 않습니다. 어플리케이션이 접속요구에 대해서 액션을 가져올 수 있도록 준비가 되었을 때, WSAAccept 함수는 다시한번 수행하고 CF_ACCEPT나 CF_REJECT 주에 하나가 조건함수로부터 반환되게 됩니다.

디폴트 모드(동기모드)상에서, 접속 대기 큐에 아무런 접속요청이 없을 때 이 함수를 호출하게 되면, 접속요구가 들어올 때 까지 어플리케이션을 블록킹 상태에 빠지게 될 것입니다. 반면에 비동기 모드 상에서 이와 똑같은 상황에서 WSAAccept 함수를 호출하게 되면, 소켓은 WSAEWOULDBLOCK 에러코드를 내면서 실패하게 됩니다. WSAAccept 함수가 성공적으로 수행되어, 새로운 소켓핸들을 반환하게 되겠죠? 이때 새로 생성되는 소켓은 다른 접속 요구를 받아들이는 소켓은 아닙니다. 머~ 당연한 거니까 굳이 부연설명은 달지 않겠습니다.

addr 매개변수는 통신계층에서 알 수 있는 형태의 접속정보에 대한 어드레스 결과를 얻어낼 매개변수입니다. addr 매개변수의 정확한 형태는 통신이 발생하는 어드레스 집합에 의해 결정됩니다. addrlen 매개변수는 함수 입력용으로 사용될 때는 addr 매개변수가 메모리상에 차지하는 크기를 가지도록 해서 넘겨야 합니다. 출력용으로 사용할 경우 이 값은 addr 매개변수에 실질적으로 포함된 어드레스의 길이(바이트)를 가지게 됩니다. 이 함수의 호출은 SOCK_STREAM과 같은 접속지향 소켓에서 사용됩니다. 만약 addr 이나 addrlen 이 NULL이라면, 접속된 소켓의 원격지 어드레스 정보는 얻어내지 못하게 됩니다.

조건함수(condition function)의 원형(prototype)은 아래와 같습니다.

int CALLBACK ConditionFunc(
        IN LPWSABUF   lpCallerId,
        IN LPWSABUF   lpCallerData,
        IN OUT LPQOS   lpSQOS,
        IN OUT LPQOS   lpGQOS,
        IN LPWSABUF   lpCalleeId,
        OUT LPWSABUF   lpCalleeData,
        OUT GROUP FAR *   g,
        IN DWORD   dwCallbackData
);

프로토타입에 대한 설명은 생략 하겠습니다. 왜냐구요? 이제 번역하기가 힘드네요. 속이 다 메슥거려여. 언제 생각나면, 이어서 해야겠습니다. 완전 "無-책임" 의 극치를 달리는군요. 캬캬캬~

Return Values

함수가 성공적으로 수행되었다면, WSAAccept 함수는 접속허용된 소켓의 기술자를 가진 SOCKET 타입의 값을 반환 할 것입니다. 에러가 발생한 경우 INVALID_SOCKET을 반환할 것이고, WSAGetLastError 함수를 호출하여 특정한 에러코드를 검색 할 수 있습니다.

Error Codes

WSANOTINITIALISED	이 함수를 사용하기 이전에 WSAStartup 함수를 성공적으로 호출해야 합니다.
WSAECONNREFUSED	접속요구가 조건함수의 리턴값에 명시된 것(CF_REJECT) 처럼 강제적으로 허용하지 못하게 되어버렸습니다.
WSAENETDOWN	네트웍 서브 시스템에 에러가 발생했습니다.
WSAEFAULT	addrlen 매개변수가 너무 작거나 addr 이나 lpfnCondition 공간이 제대로 할당되어 사용할 수 있는 영역이 아닙니다.
WSAEINTR	블럭킹 윈속 v1.1 이 WSACancelBlockingCall 함수에서 취소되었습니다
WSAEINPROGRESS	블럭킹 윈속 v1.1 이 현재 진행 중입니다.
WSAEINVAL	WSAAccept 함수를 호출하기 전에 먼저 성공적인 listen 함수가 수행되지 않았거나, 조건함수에 명시된 매개변수 g가 올바른 값이 아니거나, 하여튼 매개변수를 잘못써서 일어난 에럽니다.
WSAEMFILE	사용가능한 소켓 기술자가 남아있지 않거나 사용할 수 있는 큐가 비어있지 않습니다.
WSAENOBUFS	사용가능한 버퍼공간이 없습니다.
WSAENOTSOCK	지정된 소켓이 올바른 소켓 기술자가 아닙니다.
WSAEOPNOTSUPP	참고하도록 넘겨준 소켓이 접속지향형 타입의 소켓이 아닙니다.
WSATRY_AGAIN	접속허용요구가 조건함수의 반환값(CF_DEFER)이 가리키는 것 처럼 바로 결과를 내어 줄 수 없어 연기되었다는 것을 의미합니다.
WSAEWOULDBLOCK	비동기 소켓에서 접속을 요구한 소켓이 접속대기큐에 하나도 남아있지 않습니다.
WSAEACCES	접속요구가 시간초과가 되었거나, 취소되었습니다.

QuickInfo

Windows NT : 사용가능
Windows : 사용가능
Windows CE : 지원되지 않음
Header :
          Win16/32 : winsock.h
          Win32-II : winsock2.h
Import Library :
         Win16 : winsock.lib
          Win32 : wsock32.lib
          Win32-II : ws2_32.lib

See Also