WSAAsyncGetProtoByNumber
WSAAsyncGetProtoByNumber 함수는 비동기적으로 지정된 프로토콜 번호와 일치하는 프로토콜 정보를 반환하는 함수입니다.
HANDLE WSAAsyncGetProtoByNumber (
HWND
hWnd,
unsigned int
wMsg,
int
number,
char FAR * buf,
int buflen
);
Parameters
hWnd
[입력] 비동기적인 작업요청이 완료되었을 때 메시지를 수신받을 윈도우의 핸들
wMsg
[입력] 비동기 작업요청이 완료 되었을 때 수신받을 메시지
number
[입력] 정보를 얻고자 하는 프로토콜 번호(호스트 바이트 오더)
buf
[출력] PROTOENT 데이터를 받기위한 데이터 영역 포인터입니다. 이 데이터 영역은
PROTOENT 구조체 보다 더 커야 합니다. 왜냐믄... 데이터 영역은 윈도즈 소켓에서
PROTOENT 구조체와 PROTOENT 구조체의 모든 멤버 데이터를 포함하는데 사용되기 때문입니다.
이 버퍼의 크기는 보통 MAXGETHOSTSTRUCT 바이트 크기를 사용합니다.
buflen
[입력] buf 매개변수에 대한 데이터 영역의 크기
Remarks
WSAAsyncGetProtoByNumber 함수는 getprotobynumber 함수의 비동기 버전입니다. 즉, 지정된 프로토콜 번호와 부합하는 프로토콜 이름과 번호를 반환하는 함수죠. 윈도즈 소켓은 함수를 호출했을 때 바로 연산을 시작하고 바로 함수를 리턴하게 됩니다. 실제적인 작업은 비동기 대스크로 빽으로 보이지 않게 수행되게 됩니다. 연산이 완료되었을 때, 결과는 함수를 호출할 때 넘겼던 buffer로 카피되게 되고, 메시지는 어플리케이션 윈도우로 전달되게 됩니다.
비동기 연산이 완료 되었을 때, hWnd 매개변수로 지정된 어플리케이션 윈도우는 wMsg 매개변수로 지정된 메시지를 받게 됩니다. wParam 매개변수는 원래 첨에 함수를 호출할 때 리턴값으로 얻을 수 있었던 것과 같은 비동기 태스크 핸들을 의미합니다. lParam 의 상위 16비트는 특정한 에러코드를 의미하는데, 이 에러코드는 WINSOCK(2).H에 정의 되어 있는 에러코드중 하나가 될 수 있습니다. 에러코드가 0 일때, 비동기 연산작업은 성공적으로 이루어 졌다고 볼 수 있습니다.
성공적으로 완료되었을 때, 원래 함수 호출시 넘겨주었던 buffer로 PROTOENT 구조체를 포함하는 정보가 저장되게 되죠. 이 구조체의 멤버를 접근하기 위해서 오리쥐날 buffer 어드레스를 PROTOENT 구조체로 변환하는 캐스팅 작업이 필요 합니다. 그런 다음에 이 데이터를 사용할 수 있게 됩니다.
WSAENOBUFS 에러코드가 발생한 경우는 함수를 호출할 때 buflen 으로 넘겨주었던 buffer의 크기가 결과로 나온 정보를 모두 담기에 너무 작은 경우를 의미합니다. 이러한 경우 lParam의 하위 16비트가 필요한 버퍼의 크기를 가리키게 되므로 얼마정도의 크기를 원하는지 알 수 있습니다.
결국 중요한 점은 함수를 호출할 때 넘겨주었던 buffer에 윈도즈 소켓이 PROTOENT 구조체를 포함하는 정보를 저장하므로 적어도 MAXGETHOSTSTRUCT 바이트 만큼의 크기는 넘겨주어야 한다는 점입니다. 꼭 기억 하시기 바랍니다.
이러한 에러코드와 필요한 버퍼의 길이와 같은 데이터는 WINSOCK(2).H 에 선언되어 있는 아래의 매크로를 사용해 뽑아낼 수 있습니다.
#define WSAGETASYNCERROR(lParam) HIWORD(lParam)
//에러코드 검색
#define WSAGETASYNCBUFLEN(lParam) LOWORD(lParam)
//필요한 버퍼의 길이 검색
이러한 매크로를 사용하면, 코드의 이식성이 좋아진다고 합니다.
Return Values
리턴값은 비동기적인 연산이 성공했든 아니든간에 반환됩니다. 이 리턴값 그자체로는 연산이 정상적으로 수행되었는지 아닌지를 결정할 수는 없습니다.
만약 아무런 에러가 발생하지 않았다면, WSAAsyncGetProtoByNumber 함수는 0이 아닌 비동기 태스크 핸들을 반환 합니다(윈도즈 HTASK와 헷갈리지 마세요). 이 비동기 태스크 핸들은 두가지 용도로 사용될 수 있습니다. 첫 번째로 WSACancelAsyncRequest 함수에 사용해서 작업중이 연산을 중지 시킬 수 있고, 두 번째로 연산이 완료되었을 때 메시지를 받는 루틴에서 wParam과, 이 비동기 태스크 핸들을 비교해서 어떤 작업의 완료 메시지 인지를 비교해서 추출해 낼 수 도 있는거죠.
만약 비동기 연산이 초기화되고 시작되지 못했다면, WSAAsyncGetProtoByNumber 함수는 0값을 반환 하고, WSAGetLastError 함수를 이용해서 특정한 에러코드를 반환 할 수 있습니다.
Error Codes
아래의 에러코드는 어플리케이션 윈도우가 메시지를 받았을 때 얻어낼 수 있는 에러코드입니다. 다시말하면, 수신된 메시지중 lParam 매개변수를 WSAGETASYNCERROR 매크로를 사용해서 뽑아낼 수 있는 값입니다.
| WSAENETDOWN | 네트웍 서브 시스템에서 에러가 발생 했습니다. |
| WSAENOBUFS | 사용가능한 버퍼 공간이 부족합니다. |
| WSAEFAULT | name
또는 buf
매개변수가 처리를 하기에 올바를 형태가 아닙니다. |
| WSAHOST_NOT_FOUND | 정당한(Authoritative) 호스트를 찾아낼 수 없습니다. |
| WSATRY_AGAIN | 정당하지 않은(Non-Authoritative)를 찾을 수 없습니다. 또는 서버실패 입니다. |
| WSANO_RECOVERY | 회복할 수 없는 에러발생 |
| WSANO_DATA | 잘못된 이름(name)으로 아무런 데이터가 기록되지 않았습니다. |
아래의 에러코드는 본 함수를 호출 했을 때 발생될 수 있는 에러코드입니다. 그리고, 이러한 에러코드가 검출 되었을 때 비동기 연산은 시작 될 수 없다는 것을 의미합니다.
| WSANOTINITIALISED | 이 함수를 사용하기 이전에 WSAStartup 함수를 성공적으로 호출해야 합니다. |
| WSAENETDOWN | 네트웍 서브 시스템에서 에러가 났습니다. |
| WSAEINPROGRESS | 블럭킹 윈속 v1.1이 진행상태에 있거나, 서비스 프로바이더가 아직 콜백함수를 진행하고 있습니다. |
| WSAEWOULDBLOCK | 비동기 연산이 리소스나 다른 반대적인 요소들 때문에 진행될 수 없습니다. |
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