WSAStartup
WSAStartup 함수는 WS2_32.DLL을 사용 할 수 있도록 초기화 하는데 사용하는 함수입니다.
int WSAStartup (
WORD wVersionRequested,
LPWSADATA lpWSAData
);
Parameters
wVersionRequested
[입력] 윈도즈
소켓 함수가 사용할 가장 높은 버전을 나타냅니다. 이 2Byte의 상위 바이트는 minor
버전을 의미하고, 하위 바이트는 major 버전을 의미합니다.
lpWSAData
[출력] 윈도즈 소켓 시스템
관련 정보를 반환할 WSADATA
구조체의 포인터
Remarks
WSAStartup 함수는 윈도즈 소켓 함수중에서 가장 먼저 수행되어야 할 함수입니다. 이 함수는 사용할 윈속의 버전을 명시하고, 윈도즈 소켓 시스템 관련 정보를 반환하게 됩니다. 반드시 WSAStartup 함수를 성공적으로 호출하고 나서 다른 윈도즈 소켓함수를 사용 할 수 있다는 점을 꼭 명심하세요.
윈도즈 소켓 어플리케이션이 시작할 때 어플리케이션과 윈도우즈 소켓 시스템은 특정 버전의 윈속 API를 사용하기로 협상합니다. 어플리케이션은 사용하기를 원하는 윈속 API 버전을 wVersionRequired 파라미터에 표시합니다. WSAStartup 함수가 호출될 때 윈도즈 소켓 시스템은 지원하는 가장 낮은 윈속 API버전과 요청된 윈속 API버전을 체크합니다. 요청된 버전이 시스템이 지원하는 가장 낮은 버전보다 더 높거나 같을 경우 WSAStartup 함수의 호출은 계속 진행되고, 그다음에 윈도즈 소켓 시스템은 지원하는 가장 높은 버전의 윈속 API를 WSADATA 구조체의 wHightVersion 멤버를 반환 합니다. 또한 시스템은 가장 높은 버전과 요청된 버전 중에서 낮은 버전을 WSADATA구조체의 wVersion 에 저장합니다. 이것은 어플리케이션에 적합할 경우 사용될 윈속 API버전입니다. 어플리케이션은 wVersion 멤버의 값을 이용하여 버전이 어플리케이션에 적합한지 아닌지를 결정합니다. 아래의 표는 가능한 협상 시나리오와 그 결과를 예시한 것입니다.
| App versions | DLL Versions | wVersion Requested | wVersion | wHigh Version | End Result |
|---|---|---|---|---|---|
| 1.1 | 1.1 | 1.1 | 1.1 | 1.1 | use 1.1 |
| 1.0 1.1 | 1.0 | 1.1 | 1.0 | 1.0 | use 1.0 |
| 1.0 | 1.0 1.1 | 1.0 | 1.0 | 1.1 | use 1.0 |
| 1.1 | 1.0 1.1 | 1.1 | 1.1 | 1.1 | use 1.1 |
| 1.1 | 1.0 | 1.1 | 1.0 | 1.0 | Application fails |
| 1.0 | 1.1 | 1.0 | - | - | WSAVERNOT SUPPORTED |
| 1.0 1.1 | 1.0 1.1 | 1.1 | 1.1 | 1.1 | use 1.1 |
| 1.1 2.0 | 1.1 | 2.0 | 1.1 | 1.1 | use 1.1 |
| 2.0 | 2.0 | 2.0 | 2.0 | 2.0 | use 2.0 |
아래의 코드는 윈도즈 소켓 버전 2.2를 사용할 때 어떻게 WSAStarup 함수를 사용하여 초기화 하는지를 보여줍니다.
WORD wVersionRequested;
WSADATA wsaData;
int err;
wVersionRequested = MAKEWORD( 2, 2 );
err = WSAStartup( wVersionRequested, &wsaData );
if ( err != 0 )
{
/* 요청된 윈도즈 소켓 버전(2.2) 을 사용할 수
없습니다.*/
return;
}
/*윈도즈 소켓 DLL이 버전 2.2를 지원하는지 확인
해 봅니다.*/
/*wsaData의 wVersion 필드에 사용할 수 있는 버전이 명시되죠*/
/*이
값이 사용하기 원하는 버전 2.2인지를 비교해서 판별할 수*/
/*있습니다.*/
if ( LOBYTE( wsaData.wVersion ) != 2 ||
HIBYTE( wsaData.wVersion ) != 2 )
{
/* 요청된 윈도즈 소켓 버전(2.2) 을 사용할 수
없습니다.*/
WSACleanup( );
return;
}
/* 지정된 윈도즈 소켓이 사용하도록 성공적으로 허용되었습니다. */
WSAStartup 함수를 성공적으로 호출하고 나서 필요한 다른 윈도즈 소켓 함수를 사용 할 수 있습니다. 주의 할점은 성공적인 WSAStartup 함수의 호출과 더불어 나중에 더 이상 윈도즈 소켓을 사용할 필요가 없을 때 WSACleanup함수가 쌍으로 호출되어야 한다는 점입니다. 그래야만 윈도즈 소켓 시스템에 할당되었던 리소스들을 해제 할 수 있습니다.
실제적으로 사용될 윈도즈 소켓 시스템의 세부정보는 WSADATA 구조체에 표현됩니다.
어플리케이션이 WSAData 구조체 정보를 얻고자 한다면, WSAStartup 함수를 한번이상 호출할 수 있습니다.
Return Values
성공적으로 수행한 경우 0을 반환 하고, 그렇지 않은 경우 아래의 리스트에 나열된 에러코드중의 하나를 반환 하게 됩니다.
어플리케이션은 에러코드를 얻어내기 위해서 WSAGetLastError 함수를 호출할 수 없습니다. 왜냐구요? 윈도즈 소켓 시스템이 제대로 초기화 되지 않았으니, 당연히 WSAGetLastError 함수를 사용하지 못한다는 것이죠.
Error Codes
| WSASYSNOTREADY | 하부 네트웍 서브시스템이 아직 준비되지 않았습니다. |
| WSAVERNOTSUPPORTED | 요청한 윈도즈 소켓 버전이 현재 윈도즈 소켓 시스템에서 지원하지 않습니다. |
| WSAEINPROGRESS | 블로킹 윈속 1.1 이 현재 진행 중입니다. |
| WSAEPROCLIM | 윈속이 지원하는 최대 태스크의 수치가 한계에 도달했습니다. |
| WSAEFAULT | lpWSAData 매개변수가 적절한 포인터가 아닙니다. |
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