WSACancelAsyncRequest

WSACancelAsyncRequest

WSACancelAsyncRequest 함수는 비동기 연산중에 있는 작업을 강제적으로 종료하는 함수 입니다.

int WSACancelAsyncRequest (
HANDLE hAsyncTaskHandle
);

Parameters

hAsyncTaskHandle
[입력] 종료될 비동기 작업에 대한 태스크 핸들

Remarks

WSACancelAsyncRequest 함수는 WSAAsyncGetHostByName 함수와 같이 Y값을까지고 X값를 얻어내는 비동기 윈도즈 확장함수(원문에는 WSAAsyncGetXByY 라고 표현이 되어 있네요.)의 비동기 연산을 중도에 취소하는 함수입니다. 취소시킬 연산은 hAsyncTaskHandle 매개변수에 의해서 명시됩니다. 이 hAsyncTaskHandle은 WSAAsyncGetXByY 형태의 함수가 호출될 때 리턴되므로 이값을 임시저장 해 두었다가 WSACancelAsyncRequest 함수를 호출할 때 사용 할 수 있습니다.

이러한 비동기 작업에 대한 작업종료는 WSAEALREADY 에러코드를 내면서 실패 할 수도 있는데, 이러한 경우는 작업에 대한 결과 메시지를 이미 처리한 상태이거나 어플리케이션 윈도즈 큐에 메시지가 대기하고 있는 경우일 수 있습니다. 이러한 경우 WSACancelAsyncRequest 함수는 WSAEALREADY 에러코드를 내면서 실패하게 됩니다.

Return Values

종료작업이 성공적으로 수행된 경우 WSACancelAsyncRequest 함수는 0을 반환합니다. 그렇지 않은 경우는 SOCKET_ERROR을 리턴하게되고, WSAGetLastError 함수를 호출하여 특정한 에러코드를 얻어낼 수 있습니다.

Error Codes

WSANOTINITIALISED	이 함수를 사용하기 이전에 WSAStartup 함수를 성공적으로 호출해야 합니다.
WSAENETDOWN	네트웍 서브 시스템에서 에러가 났습니다.
WSAEINVAL	명시된 비동기 태스크 핸들이 올바른 값이 아닙니다.
WSAEINPROGRESS	블럭킹 윈속 v1.1이 진행상태에 있거나, 서비스 프로바이더가 아직 콜백함수를 진행하고 있습니다.
WSAEALREADY	종료시키려는 비동기 작업이 이미 완료된 상태입니다.

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

See Also