다음을 통해 공유

IHostIoCompletionManager::GetHostOverlappedSize 메서드

  • 아티클

호스트가 I/O 요청에 추가하려는 사용자 지정 데이터의 크기를 가져옵니다.

구문

HRESULT GetHostOverlappedSize (  
    [out] DWORD *pcbSize  
);

매개 변수

pcbSize
[out] Win32 OVERLAPPED 개체의 크기 외에도 CLR(공용 언어 런타임)에서 할당해야 하는 바이트 수에 대한 포인터입니다.

Return Value

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

설명

Windows 플랫폼 API에 대한 모든 비동기 I/O 호출은 파일 포인터 위치와 같은 정보를 제공하는 Win32 OVERLAPPED 개체를 사용합니다. 상태를 유지 관리하기 위해 비동기 I/O 호출을 만드는 애플리케이션은 일반적으로 구조체에 사용자 지정 데이터를 추가합니다. GetHostOverlappedSize 및 IHostIoCompletionManager::InitializeHostOverlapped는 호스트가 이런 사용자 지정 데이터를 포함할 수 있는 기회를 제공합니다.

CLR은 GetHostOverlappedSize 메서드를 호출하여 호스트가 OVERLAPPED 개체에 추가하려는 사용자 지정 데이터의 크기를 확인합니다.

참고

GetHostOverlappedSize는 한 번만 호출됩니다. 호스트의 사용자 지정 데이터는 모든 I/O 요청에 대해 동일한 크기여야 합니다.

중요

OVERLAPPED 개체 자체의 크기는 pcbSize 값에 포함되지 않습니다.

OVERLAPPED 구조체에 대한 자세한 내용은 Windows 플랫폼 설명서를 참조하세요.

요구 사항

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

헤더: MSCorEE.h

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

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

참고 항목