IHostControl::GetHostManager 메서드

업데이트: 2010년 12월

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

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

매개 변수

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

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

반환 값

HRESULT	설명
S_OK	GetHostManager에서 성공적으로 반환되었습니다.
HOST_E_CLRNOTAVAILABLE	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를 호출하지 않습니다.

요구 사항

플랫폼: .NET Framework 시스템 요구 사항 참조

헤더: MSCorEE.h

라이브러리: MSCorEE.dll에 리소스로 포함됨

.NET Framework 버전: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

참고 항목

참조

IHostControl 인터페이스

변경 기록

날짜	변경 내용	이유
2010년 12월	Release가 호스트 관리자에서 호출되지 않음에 대해 명확히 설명했습니다.	콘텐츠 버그 수정