GetAddrInfoExCancel 함수(ws2tcpip.h)

GetAddrInfoExCancel 함수는 GetAddrInfoEx 함수에 의해 비동기 작업을 취소합니다.

구문

INT WSAAPI GetAddrInfoExCancel(
  [in] LPHANDLE lpHandle
);

매개 변수

[in] lpHandle

취소할 비동기 작업의 핸들입니다. GetAddrInfoEx 함수에 의해 lpNameHandle 매개 변수에 반환된 핸들입니다.

반환 값

성공하면 GetAddrInfoExCancel 은 NO_ERROR (0)를 반환합니다. 오류는 Windows 소켓 오류 코드에 있는 것처럼 0이 아닌 Windows 소켓 오류 코드를 반환합니다.

설명

GetAddrInfoExCancel 함수는 비동기 GetAddrInfoEx 작업을 취소합니다. 그 결과 콜백 또는 이벤트 중 하나의 사용자 완료 메커니즘이 즉시 호출됩니다. 결과가 반환되지 않으며 GetAddrInfoEx 비동기 작업에 대해 반환된 오류 코드가 WSA_E_CANCELLED 설정됩니다. GetAddrInfoEx 요청이 이미 완료되었거나 시간이 초과되었거나 핸들이 유효하지 않은 경우 GetAddrInfoExCancel 함수에서 WSA_INVALID_HANDLE 반환됩니다.

대부분의 기본 작업(예: 레거시 이름 서비스 공급자)은 동기적이므로 이러한 작업은 실제로 취소되지 않습니다. 이러한 작업은 계속해서 리소스를 실행하고 사용합니다. 마지막 미해결 이름 서비스 공급자 요청이 완료되면 리소스가 해제됩니다.

Windows 8.1 및 Windows Server 2012 R2: 이 함수는 Windows 8.1, Windows Server 2012 R2 이상에서 Windows 스토어 앱에서 지원됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8.1, Windows 8 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	ws2tcpip.h
라이브러리	Ws2_32.lib
DLL	Ws2_32.dll

추가 정보

GetAddrInfoEx