WSASocket

WSASocket

WSASocket 함수는 트랜스포트 서비스 프로바이더에 바인드된 소켓을 생성합니다. 부수적인 기능으로, 소켓그룹에 합쳐서(join) 생성하는데 사용하기도 합니다.

SOCKET WSASocket (
        int af,
        int type,
        int protocol,
        LPWSAPROTOCOL_INFO lpProtocolInfo,
        GROUP g,
        DWORD dwFlags
);

Parameters

af
[입력] 어드레스 집합(family)를 명시합니다.

type
[입력] 새로이 생성될 소켓에 대한 형태(type)을 지정합니다.

protocol
[입력] 어드레스 집합(family)으로 지정된 소켓에서 사용되는 특정한 프로토콜

lpProtocolInfo
[입력] 생성되는 소켓의 특성을 정의한 WSAPROTOCOL_INFO 구조체에 대한 포인터

g
[입력] 소켓그룹의 식별자 로써, 소켓그룹에 대해서 나중에 사용하기 위해 예약된 매개변수입니다.

dwFlags
[입력] 소켓 속성을 지정하는 플래그

Remarks

WSASocket 함수는 소켓 기술자를 얻어내고, 관련된 리소스를 할당받는 함수입니다. 기본 설정치로, 소켓은 오버랩 속성을 가지지 않습니다. 만약 lpProtocolInfo가 NULL 이라면, WS2_32.DLL은 처음 3개 매개변수(af, type, protocol)를 소켓의 특성을 정의하는데 사용하게 됩니다. 반면, lpProtocolInfo 매개변수가 NULL 이 아니라면, 소켓은 WSAPROTOCOL_INFO 구조체의 내용을 바탕으로 하여 소켓의 특성을 정의 합니다. 이러한 경우, 어플리케이션은 FROM_PROTOCOL_INFO 상수값으로 af, type, protocol 매개변수를 넘겨줄 수 있습니다. 이러한 방법은 WSAPROTOCOL_INFO 구조체로부터(iAddressFamily, iSocket, iProtocol) 부합되는 값이 사용되도록 가정되어 있음을 의미합니다.

프로토콜과 af, type, protocol 에 기반을 둔 서비스 프로바이더를 선택할 때, 이 함수의 프로시져는 프로토콜 레이어가 아닌 기본 프로토콜이나 프로토콜 체인 만을 선택 할 것입니다. 언-체인된 프로토콜 레이어는 type 이나 af 둘중하나에 기반을 둔 "partial matches"를 고려하지 않습니다. 간단히 말하자며, 적절한 프로토콜이 발견되지 않았을 때 WSAEAFNOSUPPORT 나 WSAEPROTONOSUPPORT 에러코드를 발생하지 않는 다는 말입니다.

매개변수 g는 소켓그룹에 대한 적절한 액션을 알려주기 위해 사용됩니다.

g 매개변수가 존재하는 소켓 그룹 아이디 라면, 새로운 소켓은 그룹에 합쳐집니다.
g 매개변수가 SG_UNCONSTRAINED_GROUP 이라면, 강요성이 없는 소켓 그룹(unconstrained socket group)을 생성하고, 새로운 소켓을 가지게 됩니다.
g 매개변수가 SG_CONSTRAINED_GROUP 이라면, 강요성이 있는 소켓 그룹(constrained socket group)을 생성하고, 새로운 소켓을 가지게 됩니다.
g 매개변수가 0 이라면, 그룹연산(group operation)은 아무것도 수행되지 않습니다.

강요성이 없는 그룹에서, 특정한 소켓의 집합은 단일 서비스 프로바이더에 의해서 지원되는 것처럼 함께 포함될 수 있습니다. 강요성이 있는 소켓 그룹은 접속 지향형 소켓만으로 구성될 수 있습니다. 그리고, 모든 그룹핑된 소켓들의 접속은 같은 호스트에 같은 어드레스로 접속되도록 요구됩니다. 새로 생성된 소켓 그룹에 대해서, 새로운 그룹 아이디는 SO_GROUP_ID 옵션으로 getsockopt 함수를 호출해서 얻어낼 수 있습니다. 소켓 그룹 아이디는 주어진 서비스 프로바이더에 대한 모든 프로세스에서 유일한 값입니다.

dwFlags 매개변수는 아래의 값들을 OR 연산해서 이루어진 값을 사용하여 소켓의 속성을 명시하는데 사용할 수 있습니다.

Flag	Meaning
WSA_FLAG_OVERLAPPED	이 플래그를 사용하면, 오버랩 소켓을 생성하게 됩니다. 오버랩 소켓은 오버랩 I/O 오퍼레이션을 위하여 WSASend, WSASendTo, WSARecv, WSARecvFrom, WSAIoctl 함수를 사용할 수 있습니다. 이러한 오버랩 연산을 다루는 함수들은 오버랩과 관련된 매개변수를 NULL로 지정함으로써 넌-오버랩 소켓으로 사용 할 수도 있습니다.
WSA_FLAG_MULTIPOINT_C_ROOT	생성된 소켓이 멀티 포인트 세션에서 c_root가 될 것이라는 것을 알려주는 플래그입니다.
WSA_FLAG_MULTIPOINT_C_LEAF	생성된 소켓이 멀티 캐스트 세션에서 c_leaf가 될 것이라고 알려주는 플래그 입니다.
WSA_FLAG_MULTIPOINT_D_ROOT	생성된 소켓이 멀티 포인트 세션에서 d_root 가 될 것이라고 알려주는 플래그 입니다.
WSA_FLAG_MULTIPOINT_D_LEAF	생성된 소켓이 멀티포인트 세션에서 d_leaf가 될 것이라고 알려주는 플래그 입니다.

Return Values

에러가 발생하지 않으면, WSASocket 함수는 새로 생성된 소켓을 참조하는 기술자를 반환 합니다. 반면, 에러가 발생한 경우는, INVALID_SOCKET 이 반환 됩니다. 그리구, WSAGetLastError 함수를 호출하여 특정한 에러코드를 얻어낼 수 있습니다.

Error Codes

WSANOTINITIALISED	이 함수를 사용하기 전에 성공적인 WSAStartup 함수의 호출이 없었습니다.
WSAENETDOWN	네트웍 서브시스템에 에러가 발생했습니다.
WSAEAFNOSUPPORT	지정된 어드레스 체계(family)가 지원되지 않습니다.
WSAEINPROGRESS	블럭킹 윈속 v1.1 이 현재 진행 중이거나, 서비스 프로바이더가 콜백 함수를 여전히 처리하고 있습니다.
WSAEMFILE	사용할 수 있는 소켓기술자가 바닥 나 있어서 소켓을 생성할 수 없습니다.
WSAENOBUFS	사용할 수 있는 버퍼가 바닥 나 있어서 소켓을 생성할 수 없습니다.
WSAEPROTONOSUPPORT	지정된 프로토콜이 지원되지 않는 형식입니다.
WSAEPROTOTYPE	지정된 프로토콜이 잘못되었거나 이 소켓에 대해서 잘못된 형식입니다.
WSAESOCKTNOSUPPORT	지정된 소켓 타입이 지정한 어드레스 체계에서 지원되지 않는 형식입니다.
WSAEINVAL	매개변수 g 가 올바른 값이 아닙니다.
WSAEFAULT	lpProtocolInfo 매개변수가 올바를 값이 아닙니다.
WSAINVALIDPROVIDER	서비스 프로바이더가 2.2 버전과 다른 버전을 반환 했습니다.
WSAINVALIDPROCTABLE	서비스 프로바이더가 효력이 없거나 완료할 수 없는 프로시져 테이블을 반환했습니다.

QuickInfo

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