WSAAsyncGetProtoByName
WSAAsyncGetProtoByName 함수는 지정된 프로토콜 이름과 일치하는 프로토콜 정보를 비동기적으로 얻어내는 함수 입니다.
HANDLE WSAAsyncGetProtoByName (
HWND hWnd,
unsigned int wMsg,
const char FAR * name,
char FAR * buf,
int buflen
);
Parameters
hWnd
[입력] 비동기적인 작업요청이 완료되었을 때,
메시지를 통지받을 윈도우의 핸들
wMsg
[입력] 비동기적인 작업 요청이 완료되었을 때,
수신받을 메시지
name
[입력] null 문자로 끝나는 프로토콜 이름 포인터
buf
[출력] PROTOENT
데이터를 수신하기 위한 데이터 영역 포인터입니다. 이 데이터 영역은 PROTOENT
구조체의 크기보다 더 커야 합니다. 왜냐믄... 데이터 영역데 PROTOENT
구조체와, PROTOENT
구조체의 모든 멤버들을 포함하기위해 윈도즈 소켓이 사용하기 때문입니다. 버퍼의
크기는 MAXGETHOSTSTRUCT byte 만큼의 크기가 주로 사용됩니다.
buflen
[출력] buf
매개변수를 위한 데이터 영역의 크기
Remarks
WSAAsyncGetProtoByName 함수는 getprotobyname 함수의 비동기 버전입니다. 이 함수는 주어진 프로토콜 이름과 부합하는 프로토콜 이름과 번호를 윈도즈 소켓 데이터베이스로부터 얻어냅니다. 이 함수를 호출하고 나면, 바로 함수는 리턴됩니다. 하지만, 데이터를 얻어내기 위한 연산은 비동기 태스크로 뒤에서 수행하고 있는 거죠. 어플레케이션은 이 비동기 태스크 핸들을 사용할 수 있습니다. 데이터를 얻어내는 연산과정이 끝나게 되면, 그 결과값은 함수를 호출할 때 넘겨주었던 buf에 저장되고 hWnd로 넘겨주었던 어플리케이션 윈도우로 작업을 다 수행 했다고 메시지를 주게 됩니다.
비동기 연산이 완료되었을 때, 어플레케이션 윈도우(hWnd)는 wMsg 으로 메시지를 수신받게 됩니다. wParam 매개변수는 원래 함수를 호출하고 바로리턴 받았던 것과 같은 비동기 태스크 핸들을 받게 됩니다. 굴구, lParam의 상위 16비트는 에러코드를 가지게 됩니다. 에러코드는 WINSOCK(2).H에 정의된 특정한 에러 코드가 됩니다. 만약 에러코드가 0 이라면, 비동기 작업이 성공적으로 완료 되었다는 것을 의미합니다.
성공적인 수행 후에, 맨첨 함수를 호출할 때 매개변수로 넘겨주었던 buffer 매개변수 있죠? 이 구조체를 접근하기 위해서는 원래 넘겨주었던 buffer 어드레스를 PROTOENT 구조체로 캐스팅 해야 합니다. 그런후에 적절히 멤버를 접근 해서 사용하면 됩니다.
만약 WSAENOBUFS 에러코드가 발생 했다면, buflen으로 지정한 buffer의 크기가 정보를 저장하기에 너무 작은 경우입니다. 이런 경우 lParam의 하위 16비트는 모든 정보를 담기위해 필요한 버퍼의 크기를 가지게 됩니다.
친절하게도 lParam으로부터 에러코드와 필요한
버퍼의 크기를 뽑아내는 매크로들을 준비해 놓고 있는게 있는데요. 아래의 것을이
그것입니다. 이 매크로들은 WINSOCK(2).H에 정의 되어 있습니다.
그저 HIWORD(...)
와 LOWORD(...)를 대신했다는 것 밖에는 특별한 점이 없습니다.
#define WSAGETASYNCERROR(lParam) HIWORD(lParam)
//에러코드 검색
#define WSAGETASYNCBUFLEN(lParam) LOWORD(lParam)
//필요한 버퍼의 길이 검색
이러한 매크로 들을 사용하면, 코드의 이식성이 좋아진다고 하네요? ^^
Return Values
리턴 값은 비동기 작업이 성공적이든 아니든 명시됩니다. 이 값은 연산 그자체의 성공이나 실패를 의미하지 않습니다.
아무런 에러가 발생되지 않았다면, WSAAsyncGetProtoByName 함수는 비동기 태스크 핸들인 HANDLE 타입인 0이 아닌 값을 반환 합니다. (태스크 핸들을 윈도즈 HTASK로 혼동하지는 마세요). 이 값은 두가지 용도로 사용할 수 있습니다. 그중하나는 WSACancelAsyncRequest 함수로 작업을 취소 할 때 사용할 수 있고요, 또... 작업을 성공적으로 완료 했을 때 메시지가 오죠? 그때 wParam 메시지 매개변수와 비교해서 특정한 비동기 작업을 구분해 낼 수도 있습니다.
만약 비동기 연산이 성공적으로 시작되지 못했다면, WSAAsyncGetProtoByName 함수는 0을 리턴 합니다. 그리고, WSAGetLastError 함수의 호출로 특적한 에러코드를 얻어낼 수 있습니다.
Error Codes
아래의 에러코드는 어플리케이션 윈도우가 메시지를 받았을 때 설정될 수 있습니다. 앞서 설명 했듯이, WSAGETASYNCERROR 매크로를 이용해서 응답 메시지인 lParam으로부터 에러코드를 뽑아낼 수 있다는거져.
| 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