IHostIoCompletionManager::GetHostOverlappedSize 메서드

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

HRESULT GetHostOverlappedSize (
    [out] DWORD *pcbSize
);

매개 변수

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

반환 값

HRESULT	설명
S_OK	GetHostOverlappedSize에서 성공적으로 반환되었습니다.
HOST_E_CLRNOTAVAILABLE	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 요청에 대해 크기가 같아야 합니다.