다음을 통해 공유

ICLRIoCompletionManager::OnComplete 메서드

  • 아티클

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 구조체에 대한 포인터입니다.

Return Value

HRESULT 설명
S_OK OnComplete가 성공적으로 반환되었습니다.
HOST_E_CLRNOTAVAILABLE CLR이 프로세스에 로드되지 않았거나 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 메서드를 호출하여 런타임에 이러한 요청의 결과를 알립니다.

요구 사항

플랫폼:시스템 요구 사항을 참조하세요.

헤더: MSCorEE.h

라이브러리: 리소스로 MSCorEE.dll에 포함됩니다.

.NET Framework 버전: 2.0부터 사용 가능

참고 항목