IHostAssemblyManager::GetNonHostStoreAssemblies 메서드

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

구문

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

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

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부터 사용 가능