다음을 통해 공유


IHostAssemblyManager::GetNonHostStoreAssemblies 메서드

호스트에서 CLR(공용 언어 런타임)에 로드할 어셈블리 목록을 나타내는 ICLRAssemblyReferenceList에 대한 인터페이스 포인터를 가져옵니다.

HRESULT GetNonHostStoreAssemblies (
    [out] ICLRAssemblyReferenceList **ppReferenceList
);

매개 변수

  • ppReferenceList
    [out] 호스트에서 CLR에 로드할 어셈블리의 참조 목록이 포함된 ICLRAssemblyReferenceList의 주소에 대한 포인터입니다.

반환 값

HRESULT

설명

S_OK

GetNonHostStoreAssemblies에서 성공적으로 반환되었습니다.

HOST_E_CLRNOTAVAILABLE

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

HOST_E_TIMEOUT

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

HOST_E_NOT_OWNER

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

HOST_E_ABANDONED

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

E_FAIL

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

E_OUTOFMEMORY

메모리가 부족하여 요청된 ICLRAssemblyReferenceList의 참조 목록을 만들 수 없습니다.

설명

CLR에서는 다음 지침에 따라 참조를 확인합니다.

  • 먼저 GetNonHostStoreAssemblies에서 반환하는 어셈블리 참조 목록을 확인합니다.

  • 어셈블리가 목록에 있으면 CLR에서 정상적으로 이 어셈블리에 바인딩합니다.

  • 어셈블리가 목록에 없고 호스트에서 IHostAssemblyStore를 구현한 경우 바인딩할 어셈블리를 호스트에서 제공하도록 CLR에서 IHostAssemblyStore::ProvideAssembly를 호출합니다.

  • 그렇지 않으면 CLR에서 어셈블리에 바인딩할 수 없습니다.

호스트에서 ppReferenceList를 null로 설정하면 CLR은 먼저 전역 어셈블리 캐시를 검색하고 ProvideAssembly를 호출한 다음 응용 프로그램 기준을 검색하여 어셈블리 참조를 확인합니다.

참고참고

초기화되면 CLR에서는 GetNonHostStoreAssemblies를 한 번만 호출합니다.이 메서드는 다시 호출되지 않습니다.

요구 사항

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

헤더: MSCorEE.h

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

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

참고 항목

참조

ICLRAssemblyReferenceList 인터페이스

IHostAssemblyManager 인터페이스

IHostAssemblyStore 인터페이스