WSAProviderCompleteAsyncCall 함수(ws2spi.h)
WSAProviderCompleteAsyncCall 함수는 네임스페이스 버전-2 공급자에 대한 비동기 호출이 완료되면 클라이언트에 알립니다.
구문
INT WSAAPI WSAProviderCompleteAsyncCall(
HANDLE hAsyncCall,
INT iRetCode
);
매개 변수
hAsyncCall
완료되는 비동기 호출에 전달된 핸들입니다. 이 핸들은 비동기 함수 호출에서 클라이언트에서 네임스페이스 버전-2 공급자에 전달됩니다.
iRetCode
네임스페이스 버전 2 공급자에 대한 비동기 호출에 대한 반환 코드입니다.
반환 값
오류가 발생하지 않으면 WSAProviderCompleteAsyncCall은 0을 반환합니다.
함수가 실패하면 반환 값이 SOCKET_ERROR. 확장 오류 정보를 얻으려면 다음 확장 오류 값 중 하나를 반환하는 WSAGetLastError를 호출합니다.
| 오류 코드 | 의미 |
|---|---|
| 작업을 수행할 메모리가 부족했습니다. | |
| 내부 오류가 발생했습니다. | |
| 매개 변수가 잘못되었습니다. hAsyncCall 매개 변수가 **NULL**인 경우 이 오류가 반환됩니다. | |
| Ws2_32.dll 초기화되지 않았습니다. 애플리케이션은 Windows 소켓 함수를 호출하기 전에 먼저 WSAStartup 을 호출해야 합니다. |
설명
WSAProviderCompleteAsyncCall 함수는 Windows Vista 이상에서 사용할 수 있는 네임스페이스 서비스 공급자 버전 2(NSPv2) 아키텍처의 일부로 사용됩니다.
Windows Vista 및 Windows Server 2008에서 WSAUnadvertiseProvider 함수는 NS_EMAIL 네임스페이스 공급자의 작업에만 사용할 수 있습니다. NSPv2 공급자에 대한 비동기 호출은 Windows Vista 및 Windows Server 2008에서 지원되지 않습니다. 따라서 WSAProviderCompleteAsyncCall 은 현재 적용되지 않습니다. 이 함수는 네임스페이스 공급자에 대한 비동기 호출이 지원되는 경우 이후 버전의 Windows에서 사용할 계획입니다.
일반적으로 NSPv2 공급자는 호출 애플리케이션 이외의 프로세스에서 구현됩니다. NSPv2 공급자는 클라이언트 작업의 결과로 활성화되지 않습니다. 애플리케이션을 호스팅하는 각 공급자는 WSAAdvertiseProvider 및 WSAUnadvertiseProvider 함수 를 호출하여 특정 공급자를 사용할 수 있거나 사용할 수 없는 시기를 결정합니다. 클라이언트 활동은 사용 가능한 경우(네임스페이스 공급자가 보급될 때) 공급자에게 연락하려는 시도만 발생합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | ws2spi.h |
| 라이브러리 | Ws2_32.lib |
| DLL | Ws2_32.dll |