IMetaDataAssemblyImport::FindAssembliesByName 메서드
CLR(공용 언어 런타임)에서 참조를 확인하는 데 사용하는 표준 규칙을 사용하여 지정된 szAssemblyName 매개 변수를 가진 어셈블리의 배열을 가져옵니다.
HRESULT FindAssembliesByName (
[in] LPCWSTR szAppBase,
[in] LPCWSTR szPrivateBin,
[in] LPCWSTR szAssemblyName,
[out] IUnknown *ppIUnk[],
[in] ULONG cMax,
[out] ULONG *pcAssemblies
);
매개 변수
szAppBase
[in] 지정된 어셈블리를 검색할 루트 디렉터리입니다. 이 값이 null로 설정되어 있으면 FindAssembliesByName은 전역 어셈블리 캐시에서만 어셈블리를 검색합니다.szPrivateBin
[in] 어셈블리를 검색할 루트 디렉터리 아래의 하위 디렉터리가 들어 있는 세미콜론으로 구분된 목록(예: "bin;bin2")입니다. 이러한 디렉터리는 기본 조사 규칙에 지정된 디렉터리와 함께 조사됩니다.szAssemblyName
[in] 찾을 어셈블리의 이름입니다. 이 문자열의 형식은 AssemblyName의 클래스 참조 페이지에 정의되어 있습니다.ppIUnk
[in] IMetadataAssemblyImport 인터페이스 포인터를 넣을 IUnknown 형식의 배열입니다.cMax
[out] ppIUnk에 추가할 수 있는 인터페이스 포인터의 최대 개수입니다.pcAssemblies
[out] 반환된 인터페이스 포인터의 수입니다. 즉, 이 수만큼의 인터페이스 포인터가 실제로 ppIUnk에 추가됩니다.
반환 값
HRESULT |
설명 |
|---|---|
S_OK |
FindAssembliesByName에서 성공적으로 반환되었습니다. |
S_FALSE |
어셈블리가 없습니다. |
설명
FindAssembliesByName 메서드에서는 어셈블리 참조를 확인하기 위한 표준 규칙을 따라 지정된 어셈블리 이름의 어셈블리를 찾습니다. 자세한 내용은 런타임에서 어셈블리를 찾는 방법을 참조하십시오. 호출자는 FindAssembliesByName을 사용하여 어셈블리 확인기 컨텍스트의 응용 프로그램 기본 및 개인 검색 경로와 같은 다양한 특성을 구성할 수 있습니다.
FindAssembliesByName 메서드에서 어셈블리 확인 논리를 호출하려면 프로세스에 CLR이 초기화되어 있어야 합니다. 따라서 FindAssembliesByName을 호출하기 전에 COINITEE_DEFAULT를 전달하여 CoInitializeEE를 호출한 다음 CoUninitializeCor를 호출해야 합니다.
FindAssembliesByName은 전달된 어셈블리 이름의 어셈블리 매니페스트가 들어 있는 파일에 대한 IMetaDataImport 포인터를 반환합니다. 지정된 어셈블리 이름에 버전이 포함되지 않은 경우와 같이 어셈블리 이름이 완전히 지정되지 않은 경우에는 여러 개의 어셈블리가 반환될 수 있습니다.
FindAssembliesByName은 일반적으로 컴파일러에서 컴파일 타임에 참조된 어셈블리를 찾으려고 할 때 사용됩니다.
요구 사항
플랫폼: .NET Framework 시스템 요구 사항 참조
헤더: Cor.h
라이브러리: MsCorEE.dll에서 리소스로 사용됨
.NET Framework 버전: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0, 1.1, 1.0