다음을 통해 공유


IHostAssemblyManager::GetNonHostStoreAssemblies 메서드

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

구문

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

매개 변수

ppReferenceList
[out] 호스트가 CLR에서 로드할 것으로 예상하는 어셈블리에 대한 참조 목록을 포함하는 ICLRAssemblyReferenceList 주소에 대한 포인터입니다.

Return Value

HRESULT 설명
S_OK GetNonHostStoreAssemblies가 성공적으로 반환되었습니다.
HOST_E_CLRNOTAVAILABLE CLR이 프로세스에 로드되지 않았거나 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를 한 번만 호출합니다. 이 메서드는 다시 호출되지 않습니다.

요구 사항

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

헤더: MSCorEE.h

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

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

참고 항목