IHostControl::GetHostManager 메서드

지정된 IID 인터페이스의 호스트 구현에 대한 인터페이스 포인터를 가져옵니다.

구문

HRESULT GetHostManager (  
    [in] REFIID riid,  
    [out, iid_is(riid)] void** ppObject  
);  

매개 변수

riid
[in] IID CLR(공용 언어 런타임)이 쿼리하는 인터페이스입니다.

ppObject
[out] 호스트 구현 인터페이스에 대한 포인터이거나, 호스트가 이 인터페이스를 지원하지 않는 경우 null입니다.

Return Value

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

설명

CLR은 호스트를 쿼리하여 다음 인터페이스 중 하나 이상을 지원하는지 여부를 확인합니다.

• IHostMemoryManager

• IHostTaskManager

• IHostThreadPoolManager

• IHostIoCompletionManager

• IHostSyncManager

• IHostAssemblyManager

• IHostGCManager

• IHostPolicyManager

• IHostSecurityManager

호스트가 지정된 인터페이스를 지원하는 경우 ppObject를 해당 인터페이스의 구현으로 설정합니다. 그렇지 않으면, ppObject가 null로 설정됩니다.

사용자가 종료하더라도 CLR은 호스트 관리자에서 Release를 호출하지 않습니다.

요구 사항

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

헤더: MSCorEE.h

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

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

참고 항목

• IHostControl 인터페이스