다음을 통해 공유


ICLRControl::GetCLRManager 메서드

호스트에서 CLR(공용 언어 런타임)을 구성하는 데 사용할 수 있는 관리자 형식의 인스턴스에 대한 인터페이스 포인터를 가져옵니다.

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

매개 변수

  • riid
    [in] 반환할 관리자 형식의 IID입니다. 다음 IID 값을 사용할 수 있습니다.

    • IID_ICLRDebugManager: ppObject의 형식이 ICLRDebugManager가 되도록 지정합니다.

    • IID_ICLRErrorReportingManager: ppObject가 형식 ICLRErrorReportingManager가 되도록 지정합니다.

    • IID_ICLRGCManager: ppObject의 형식이 ICLRGCManager가 되도록 지정합니다.

    • IID_ICLRHostProtectionManager: ppObject의 형식이 ICLRHostProtectionManager가 되도록 지정합니다.

    • IID_ICLROnEventManager: ppObject의 형식이 ICLROnEventManager가 되도록 지정합니다.

    • IID_ICLRPolicyManager: ppObject의 형식이 ICLRPolicyManager가 되도록 지정합니다.

    • IID_ICLRTaskManager: ppObject의 형식이 ICLRTaskManager가 되도록 지정합니다.

  • ppObject
    [out] 요청한 관리자에 대한 인터페이스 포인터입니다. 잘못된 관리자 형식을 요청한 경우는 null입니다.

반환 값

HRESULT

설명

S_OK

메서드가 성공적으로 반환했습니다.

HOST_E_CLRNOTAVAILABLE

CLR이 프로세스에 로드되지 않았거나 관리 코드를 실행할 수 없는 상태 또는 호출을 처리할 수 없는 상태입니다.

HOST_E_TIMEOUT

호출 시간이 초과되었습니다.

HOST_E_NOT_OWNER

호출자가 잠금을 소유하고 있지 않습니다.

HOST_E_ABANDONED

차단된 스레드나 파이버가 기다리던 이벤트가 취소되었습니다.

E_FAIL

알 수 없는 치명적인 오류가 발생했습니다. 메서드가 E_FAIL을 반환한 후에는 프로세스에서 CLR을 더 이상 사용할 수 없습니다. 이후에 호스팅 메서드를 호출하면 HOST_E_CLRNOTAVAILABLE이 반환됩니다.

E_NOINTERFACE

이 인터페이스 형식은 지원되지 않습니다.

요구 사항

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

헤더: MSCorEE.h

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

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

참고 항목

참조

ICLRControl 인터페이스

IHostControl 인터페이스