ICLRIoCompletionManager::OnComplete 메서드

아티클
08/09/2011

IHostIoCompletionManager::Bind 메서드를 호출하여 만든 I/O 요청의 상태를 CLR(공용 언어 런타임)에 알립니다.

HRESULT OnComplete (
    [in] DWORD dwErrorCode,
    [in] DWORD NumberOfBytesTransferred,
    [in] void* pvOverlapped
);

매개 변수

dwErrorCode
[in] 바인딩 작업의 상태를 나타내는 HRESULT 값입니다.
- S_OK는 작업이 성공적으로 완료되었음을 나타냅니다.
- HOST_E_INTERRUPTED는 완료되기 전에 호출이 종료되었음을 나타냅니다.
- E_FAIL은 알 수 없는 치명적인 오류가 발생했으며 이 오류를 복구할 수 없음을 나타냅니다.
NumberOfBytesTransferred
[in] I/O 요청을 처리하는 동안 전송된 바이트 수입니다.
pvOverlapped
[in] IHostIoCompletionManager::Bind 메서드 호출에 전달된 OVERLAPPED 구조체에 대한 포인터입니다.

반환 값

HRESULT	설명
S_OK	OnComplete에서 성공적으로 반환되었습니다.
HOST_E_CLRNOTAVAILABLE	CLR이 프로세스에 로드되지 않았거나 관리 코드를 실행할 수 없는 상태 또는 호출을 처리할 수 없는 상태입니다.
HOST_E_TIMEOUT	호출 시간이 초과되었습니다.
HOST_E_NOT_OWNER	호출자가 잠금을 소유하고 있지 않습니다.
HOST_E_ABANDONED	차단된 스레드나 파이버가 기다리던 이벤트가 취소되었습니다.
E_FAIL	알 수 없는 치명적인 오류가 발생했습니다. 메서드가 E_FAIL을 반환한 후에는 프로세스에서 CLR을 더 이상 사용할 수 없습니다. 이후에 호스팅 메서드를 호출하면 HOST_E_CLRNOTAVAILABLE이 반환됩니다.

설명

호스트에서 I/O 완료 추상화를 구현하는 경우 CLR에서는 IHostIoCompletionManager의 메서드를 사용하여 호스트를 통해 I/O 요청을 수행합니다. 그런 다음 호스트는 OnComplete 메서드를 호출하여 공용 언어 런타임에 이러한 요청의 결과를 알립니다.