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