connect
connect 함수는 지정된 소켓을 지정된 원격지로 접속을 이루는 함수입니다.
int connect (
SOCKET
s,
const struct
sockaddr FAR* name,
int
namelen
);
Parameters
s
[입력]
접속되지 않은 소켓을 식별하는 기술자(descriptor).
name
[입력]
어디로 접속할 것인지에 대한 정보를 담은 SOCKADDR
구조체
namelen
[입력]
name
매개변수의 크기
Remarks
connect 함수는 명시된 목적 호스트로의 접속을 이루는데 사용되는 함수입니다. 만약 SOCKET s 매개변수가 bind되지 않은 상태라면, 윈도우즈 소켓 시스템은 인터페이스 어드레스와 포트번호를 소켓에 묶을(bind) 것입니다. 이는 bind 함수가 인터페이스 어드레스와 포트번호를 각각 INADDR_ANY 와 0 으로 지정하여 소켓에서 호출된 것과 유사합니다.
접속 지향형 소켓(connection-oriented sockets : SOCK_STREAM)의 경우 접속은 name (SOCKADDR 구조체를 참고하세요.) 매개변수에 지정된 다른 호스트로 실제적인 연결이 설정됩니다.. 소켓이 이 함수를 성공적으로 호출했을때 소켓은 데이터를 전송하고 수신할 준비가 되어있게 됩니다. 만약 지정된 name 매개변수의 구조체의 주소 멤버가 모두 0 으로 셋팅되어 있다면, connect 함수는 WSAEADDRNOTAVAIL 이라는 에러를 리턴할 것입니다. 이미 운용중인 접속된 소켓을 다시 접속하려 할 때는 WSAEISCONN 에러 코드를 발생하며, 접속에 실패하게 됩니다.
접속 지향형인 비동기 소켓(connection-oriented nonblocking sockets)의 경우 종종 바로 접속이 이루어 지지 않습니다. 이런경우에 connect 함수는 WSAEWOULDBLOCK 에러코드를 발생하게 됩니다. 하지만, 접속하는 과정은 계속 수행되므로 이런 상황을 두고 접속에러 라고 볼수는 없습니다. connect 에 대한 성공 또는 실패의 결과를 알게 되었을때, 소켓은 어떤방법으로 통지메세지를 받을 것인가에 대해 보고됩니다. 만약 클라이언트가 select 함수를 사용했다면, 성공은 writefds set 이라고 알려지며, 실패 했을경우는 exceptfds set 이라고 알려집니다. 만약 클라이언트가 WSAAsyncSelect 함수나 WSAEventSelect 함수를 사용했다면, 접속에 대한 통지메세지는 FD_CONNECT 로 알려집니다. 그리고, FD_CONNECT 와 관련된 에러코드는 성공했거나 특별한 이유로 실패 했건간에 발생합니다.
비접속 지향형 소켓(connectionless socket : SOCK_DGRAM)의 경우 connect 함수에 의해서 수행되는 연산은 단지 나중에 사용될 send/WSASend, recv/WSARecv 함수에 대한 기본 목적 주소를 확립 하기위해 사용됩니다. name 매개변수중에 주소부분이 모두 0으로 설정되어 있다면, 소켓은 "dis-connected" 될 것입니다. 따라서 기본 원격지 주소가 결정되지 않았으므로 이런 경우에 send/WSASend, recv/WSARecv 함수를 사용하면, WSAENOTCONN 이라는 에러코드를 리턴할 것입니다. 하지만, 이런 경우엔 sendto/WSASendTo, recvfrom/WSARecvFrom 함수는 여전히 사용 가능 합니다. 기본 목적지 주소는 connect 함수를 다시한번 호출함으로써 간단히 바꿀 수 있습니다. 비접속 지향형 소켓인 경우엔 이전에 이미 접속된 상태 라고 할 지라도, 상관없습니다. 만약 새로 connect되는 name 이 이전에 접속된 정보와 다르다면, 수신하기 위해서 큐에 저장되었던 데이터그램 데이터는 없어져 버립니다.
비접속 지향형 소켓의 경우 name 매개변수는 브로드캐스트(broadcast) 주소를 포함한 올바른 주소를 나타낼수 있습니다. 하지만, 브로드캐스트 주소에 접속하기 위해서는 SO_BROADCAST 옵션을 체크하기위해 setsockopt 함수를 이용하여야 합니다. 그렇지 않으면, connect 함수는 WSAEACCES 에러코드를 내면서 실패 할 것입니다.
Windows CE: Windows CE 에서는 WSAEINTR 에러 코드를 지원하지 않습니다.
IrSocket에서의 구현 방법에 대해서:
IrSockets은 sockaddr_irda 형태의 주소로 connect 함수를 구현합니다. 일반적으로 클라이언트 어플리케이션은 socket 함수를 사용해서 socket을 생성하고, IRLMP_ENUMDEVICES 소켓 옵션으로 IrDa 디바이스에 대한 것들을 스캔하고, 반환되는 주소 형태의 리스트로부터 디바이스를 선택 할 것입니다. 그리고 connect 함수를 호출합니다. 동기소켓과 비동기 소켓과의 차이점은 없습니다.
Return Values
에러가 발생하지 않을 경우 connect 함수는 0을 리턴합니다. 에러가 발생한 경우 SOCKET_ERROR를 리턴하고 특정한 에러코드는 WSAGetLastError 함수를 호출 함으로써 얻을 수 있습니다.
동기소켓(blocking socket) 에서 리턴 값은 접속 시도의 성공 또는 실패 값을 의미합니다.
비동기 소켓(nonblocking socket) 에서 접속 시도는 바로 완료될 수 없습니다. 이런 경우에, connect 함수는SOCKET_ERROR 를 리턴 할 것입니다. 그리고 WSAGetLastError 함수는 WSAEWOULDBLOCK 에러코드를 리턴 할 것입니다. 이런경우에 접속처리의 완료를 알아내기 위해 우리가 취할 수 있는방법이 3가지가 있습니다.
비동기 소켓(nonblocking socket)에서 접속 시도가 완료되지 전에, 같은 소켓에 대한 다음에 이어지는 connect 함수의 호출은 WSAEALREADY 에러 코드를 발생하는 실패로 돌아갈 것이고 접속이 성공적으로 완료 된 상태에서의 connect 함수의 호출은 WSAEISCONN 에러 코드를 발생하는 실패로 돌아갈 것입니다. 즉, 어플리케이션에서 이중으로 connect 함수를 호출하는것은 바람직 하지 않습니다. 하지만, 만약 에러코드가 접속 시도 실패와 같은 에러 코드를 의미한다면( 예를들어 WSAECONNREFUSED, WSAENETUNREACH 와 같이) 같은 소켓에 대해서 다시 connect 함수를 호출 할 수 있습니다.
| WSANOTINITIALISED | 이 함수를 사용하기 전에 성공적인 WSAStartup 함수의 호출이 없었습니다. |
| WSAENETDOWN | 네트웍 서브 시스템에 에러가 발생했습니다. |
| WSAEADDRINUSE |
지정된 어드레스가 이미 사용중 입니다. |
| WSAEINTR | 블럭킹 윈속 v1.1 이 WSACancelBlockingCall 함수에서 취소되었습니다 |
| WSAEINPROGRESS | 블럭킹 윈속 v1.1 이 현재 진행 중이거나, 서비스 프로바이더가 콜백 함수를 여전히 처리하고 있습니다. |
| WSAEALREADY | 비동기 connect 오퍼레이션 호출이 지정된 소켓에서 현재 진행 중입니다. |
| WSAEADDRNOTAVAIL | 원격 어드레스가 ADDR_ANY 와 같이 올바로된 어드레스가 아닙니다. |
| WSAEAFNOSUPPORT | 지정된 어드레스 체계가 윈속에서 사용할 수 없는 형태 입니다. |
| WSAECONNREFUSED | 접속시도가 강제로 종료되었습니다. |
| WSAEFAULT | name 또는 namelen 매개변수가 올바른 형태가 아닙니다. |
| WSAEINVAL | s 매개변수가 리슨소켓이거나, 지정된 목적지 주소가 일관적이지 않습니다. |
| WSAEISCONN | 접속지향형 소켓(SOCK_STREAM) 에서 소켓이 이미 연결되어 있습니다. |
| WSAENETUNREACH | 네트웍이 현재 지정된 호스트로 연결될 수 없습니다. |
| WSAENOBUFS |
남아있는 버퍼 공간이 없어서 소켓은 접속 할 수 없습니다. |
| WSAENOTSOCK | 기술자(descriptor)가 소켓 기술자가 아닙니다. |
| WSAETIMEDOUT |
접속 시도가 시간초과 되었습니다. |
| WSAEWOULDBLOCK |
소켓이 비동기 소켓으로 마킹되어 있을 경우 즉시 접속연산을 완료할 수 없을 때 수시로 나옵니다. |
| WSAEACCES |
브로드캐스트(broadcast) 어드레스를 위한 데이터그램 소켓의 접속시도가 setsockopt 함수로 SO_BROADCAST 가 설정되어있지 않은 상태에서 실패 했습니다. |
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
overview, accept, bind, getsockname, select, socket, WSAAsyncSelect, WSAConnect