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 |