WSAConnect

WSAConnect

WSAConnect 함수는 다른 소켓 어플리케이션과 접속을 이루고, 접속 데이터를 교환하고, 매개변수로 지정되는 FLOWSPEC 구조체에 기반을 둔 필요한 서비스의 특성을 지정하는 함수 입니다.

int WSAConnect (
        SOCKET s,
        const struct sockaddr FAR * name,
        int namelen,
        LPWSABUF lpCallerData,
        LPWSABUF lpCalleeData,
        LPQOS lpSQOS,
        LPQOS lpGQOS
);

Parameters

s
[입력] 접속하고자 하는 소켓을 지정하는 기술자.

name
[입력] 접속하고자 하는 다른 어플리케이션에 있는 소켓의 이름(SOCKADDR)

namelen
[입력] 이름(sockaddr)의 길이

lpCallerData
[입력] 접속하는 동안 상대방 소켓에게 보낼 유저 데이터의 포인터

lpCalleeData
[출력] 접속하는 동안 상대방에게 전송받을 유저 데이터의 포인터

lpSQOS
[입력] 소켓 s 에 대한 FLOWSPEC 구조체의 포인터

lpGQOS
[입력] 소켓그룹(socket group)에 사용하기 위해서 예약된 매개변수입니다. 이 값은 소켓그룹에 대한 FLOWSPEC 구조체의 포인터 입니다.

Remarks

WSAConnect 함수는 지정된 상대방으로 접속을 이루고, 접속하는 동안 다른 몇몇개의 부수적인 연산을 수행하는 함수입니다. 만약 바인드 되지 않은 소켓 s를 넘겨주어 이 함수를 호출한다면, 소켓시스템과 연관된 로컬영역에는 유일한 값이 할당되고, 소켓은 바인드 됩니다.

접속지향형 소켓(ex. SOCK_STREAM 형태의 소켓)에서 활성화된 접속은 name 매개변수를 이용하여 외부 호스트로 접속을 시작합니다. 이 함수가 성공적으로 완료되었을 때, 소켓은 데이터의 전송/수신을 위한 준비가 되었다고 보면 됩니다. 이 name 구조체의 address 필드가 모두 0 이라면 어떻게 될까요? 당연히 에러를 내게 되는데, WSAEADDRNOTAVAIL 에러코드를 발생하게 됩니다. 또한 이미 접속되어 있는 소켓을 다시 접속하려 할 때도 에러를 내게 되는데, 이 때 WSAEISCONN 에러코드를 발생하며 실패하게 됩니다.

비동기 소켓인 접속지향형 소켓에서, 이 함수는 종종 접속작업이 바로 완료되지 않는 경우가 있습니다. 이러한 경우 이 함수는 WSAEWOULDBLOCK 에러코드를 발생하게 됩니다. 하지만, 이러한 경우는 에러상황이라고 볼 수 없습니다. 접속작업은 계속 진행 되고 있기 때문이죠. 함수가 성공했다 실패했다를 알 수 있는 상태가 되었을 때 어플리케이션이 이러한 통지를 어떻게 받을지 지정한 방법에 의해서 보고를 받을 수 있습니다. 클라이언트가 select 함수를 이용했다면, 함수가 성공한 경우 writefds 가 설정되고, 실패한 경우 exceptfds 가 설정됩니다. WSAAsyncSelect 함수나 WSAEventSelect 함수를 사용한 경우, FD_CONNECT 메시지와, FD_CONNECT와 관련된 에러코드가 통지될 것입니다.

비접속 소켓(ex. SOCK_DGRAM 타입)에서, WSAConnect 함수로 수행되는 연산은 나중에 사용될 접속지향형 전송/수신에 사용할 수 있게 하기위해 기본 목적지 어드레스만을 지정합니다. 중의 해야 할 점이 하나 있는데, 만약 이 함수로 지정되지 않은 목적지 어드레스와 다른 곳으로부터 날라온 데이터 그램은 버려지게 됩니다. name 구조체의 address 필드가 모두 0 이라면, 소켓의 접속은 끊겨 버리고, 기본 상대방 어드레스틑 확정되지 않은 값을 가지게 되므로, send/WSASend 함수나 recv/WSARecv 함수는 WSAENOTCONN 에러코드를 내며 실패하게 될 것입니다. 즉 사용 할 수 없다는 말이죠. 하지만, sendto/WSASendTo 함수와 recvfrom/WSARecvFrom 함수는 여전히 사용가능합니다. 기본 목적지 주소는 간단히 WSAConnect 함수를 다시 호출함으로써 변경이 가능합니다. 이전에 대상 소켓이 접속된 상태였어도 가능합니다. 이럴 경우에 주의 해야 할 점이 하나 있는데, 수신하기 위해 큐에 버퍼링 되어 있던 데이터그램은 모두 버려진다는 것입니다. 물론 새로 설정한 목적지가 이전에 설정한 목적지와 다를 경우에만 말이죠.

비접속 지향형 소켓에서, name 매개변수는 브로드캐스트 어드레스를 지정하여 사용 할 수 있습니다. 하지만, 브로트캐스팅 하기위해 접속을 시도하기 위해서는 setsockopt 함수로 SO_BROADCAST를 설정해야 합니다. 만약 이렇게 설정하지 않고 브로드캐스팅을 하려 한다면, WSAConnect 함수는 WSAEACCES 에러코드를 내면서 실패하게 될 것입니다.

lpCallerData 는 접속 요청을 하는동안 전송할 특정한 유저 데이터를 가지고 있는 매개변수입니다. 만약 lpCallerData가 NULL 이라면, 유저 데이터는 상대방에게 전송되지 않습니다. lpCalleeData는 접속하는동안 상대방에게 유저 데이터를 받을 WSABUF 구조체의 포인터입니다. lpCalleeData 의 len 필드는 lpCalleeData 의 buf 필드에 할당된 메모리 공간의 크기를 설정하는 값입니다. 만약 상대방으로부터 유저 데이터가 들어오지 않았다면, lpCalleeData의 len 필드는 0으로 설정될 것입니다. 동기소켓에서, 접속연산은 WSAConnect 함수가 반환 될 때 완료됩니다. 비동기 소켓에서의 작업은 FD_CONNECT 통지가 발생한 후에 완료될 것입니다. 만약 lpCalleeData 가 NULL 이면, 유저 데이터는 받지 않습니다.

접속할 때, 어플리케이션은 SIO_SET_QOS 또는 SIO_SET_GROUP_QOS 연산코드로 WSAIoctl 함수를 이용해서 이전에 설정한 서비스의 특성(quality of service; QOS)를 무시하기위해 lpSQOS 와 lpGQOS 매개변수를 사용할 수 있습니다.

Return Values

에러가 발생하지 않으면, WSAConnect 함수는 0을 반환 합니다. 에러가 발생한 경우, SOCKET_ERROR를 반환하고, WSAGetLastError 함수를 사용해서 특정한 에러코드를 얻어낼 수 있습니다. 동기소켓에서의 반환값은 접속 시도의 성공과 실패를 의미하게 됩니다.

비동기 소켓에서 접속시도는 바로 완료되지 않을 수 잇습니다. 이러한 경우 WSAConnect 함수는 SOCKET_ERROR을 반환하고, WSAEWOULDBLOCK 에러코드를 발생하게 됩니다. 주의 해야 할 점은 이러한 경우 즉, SOCKET_ERROR를 반환하고, WSAEWOULDBLOCK 에러코드를 발생하는 경우는 접속 연산이 확실히 실패한 경우가 아니라는 것입니다. 접속연산의 완료 상태를 체크하기 위해 어플리케이션은 아래와 같은 방법을 취할 수 있습니다.

select 함수를 사용하여 소켓이 writeable 이라는 상태를 체크함으로써 접속 요구의 완료를 결정하는데 사용할 수 있습니다.
접속 이벤트를 알아내기 위해서 WSAAsyncSelect 함수를 사용한다면, 접속연산이 완료 되었을 때(접속이 성공하는 실패하든) FD_CONNECT 통지를 받을 것입니다.
접속 이벤트를 알아내기 위해서 WSAEventSelect 함수를 사용한다면, 접속연산이 완료 되었을 때(접속이 성공하는 실패하든) 관련된 이벤트 오브젝트는 신호를 받을 것입니다.

비동기 소켓에서, 접속시도가 완료 되기전에 WSAConnect 함수에 지정한 소켓을 가지고 소켓함수를 사용하게 되면, WSAEALREADY 라는 에러코드를 발생하면서 실패할 것입니다.

에러코드가 접속시도 실패(즉, WSAECONNREFUSED, WSAENETUNREADCH, WSAETIMEOUT) 인 경우 어플리케이션은 같은 소켓으로 다시 WSAConnect 함수를 호출 할 수 있씁니다.

Error Codes

WSANOTINITIALISED	이 함수를 사용하기 이전에 WSAStartup 함수를 성공적으로 호출해야 합니다.
WSAENETDOWN	네트웍 서브 시스템에 에러가 발생했습니다.
WSAEADDRINUSE	소켓이 어드레스의 재사용 옵션이 SO_REUSEADDR을 마킹하지 않은 상태에서 지정된 소켓의 어드레스가 이미 사용중일 때.
WSAEINTR	동기 소켓에서 사용되었을 때 이 작업이 WSACancelBlockingCall 함수에 의해서 중지 되었을 경우.
WSAEINPROGRESS	블럭킹 윈속 v1.1 이 현재 진행 중입니다. 또는 다른 서비스 프로바이더가 다른 콜백함수를 처리하고 있습니다.
WSAEALREADY	비동기 connect/WSAConnect 함수가 지정한 소켓에 대해서 이전에 호출되었는데, 현재 그 작업을 처리 중에 있습니다.
WSAEADDRNOTAVAIL	지정한 원격지 어드레스가 사용할 수 있는 어드레스가 아닙니다. (ADDR_ANY를 마킹 했는지 확인해 보세요)
WSAEAFNOSUPPORT	특별히 지정된 어드레스 집합(family)이 이 소켓에 대해서 사용될 수 없습니다.
WSAECONNREFUSED	접속시도가 리젝트(reject)되었습니다.
WSAEFAULT	name 이나 namelen 매개변수가 제대로 할당받은 공간이 아닙니다. 또는 namelen 매개변수가 너무 작거나, lpCalleeData 와 lpSQOS, lpGQOS에 대한 버퍼길이가 너무 작거나 lpCallerData 의 버퍼 길이가 너무 큽니다.
WSAEINVAL	s 매개변수가 리슨 소켓으로 사용되고 있는 경우.
WSAEISCONN	접속 지향형 소켓에서 소켓이 이미 접속되어 있는 경우
WSAENETUNREACH	현재 네트웍이 상대방까지 도달하지 않습니다.
WSAENOBUFS	사용가능한 버퍼공간이 없어서 소켓은 접속할 수 없습니다.
WSAENOTSOCK	지정한 기술자가 소켓이 아닙니다.
WSAEOPNOTSUPP	lpSQOS, lpGQOS 로 지정된 FLOWSPEC 구조체가 완벽하지 않습니다.
WSAEPROTONOSUPPORT	lpCallerData 매개변수를 서비스 프로바이더가 지원하지 않습니다.
WSAETIMEDOUT	접속 시도가 타임 아웃 되었습니다.
WSAEWOULDBLOCK	비동기 소켓이고, 접속이 바로 완료되지 않은 경우
WSAEACCES	setsockopt 함수에서 SO_BROADCAST를 설정하지 않고, 데이터그램 소켓을 브로드캐스트 어드레스로 접속하려 하는 시도가 있었습니다.

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