IMetaDataAssemblyImport::FindAssembliesByName 메서드(rometadataapi.h)
참조를 확인하기 위해 CLR(공용 언어 런타임)에서 사용하는 표준 규칙을 사용하여 지정된 이름의 어셈블리 배열을 가져옵니다.
구문
HRESULT FindAssembliesByName(
[in] LPCWSTR szAppBase,
[in] LPCWSTR szPrivateBin,
[in] LPCWSTR szAssemblyName,
[out] IUnknown * [] ppIUnk,
[in] ULONG cMax,
[out] ULONG *pcAssemblies
);
매개 변수
[in] szAppBase
지정된 어셈블리를 검색할 루트 디렉터리입니다. 이 값을 null로 설정하면 FindAssembliesByName 은 어셈블리의 전역 어셈블리 캐시에서만 표시됩니다.
[in] szPrivateBin
세미콜론으로 구분된 하위 디렉터리 목록(예: "bin; bin2"), 어셈블리를 검색할 루트 디렉터리 아래에 있습니다. 이러한 디렉터리가 기본 검색 규칙에 지정된 디렉터리 외에 검색됩니다.
[in] szAssemblyName
찾을 어셈블리의 이름입니다. 이 문자열의 형식은 AssemblyName에 대한 클래스 참조 페이지에 정의되어 있습니다.
[out] ppIUnk
IMetadataAssemblyImport 인터페이스 포인터를 배치할 IUnknown 형식의 배열입니다.
[in] cMax
ppIUnk에 배치할 수 있는 최대 인터페이스 포인터 수입니다.
[out] pcAssemblies
반환된 인터페이스 포인터의 수입니다. 즉, 실제로 ppIUnk에 배치된 인터페이스 포인터의 수입니다.
반환 값
HRESULT | Description |
---|---|
S_OK | FindAssembliesByName이 성공적으로 반환되었습니다. |
S_FALSE | 어셈블리가 없습니다. |
설명
어셈블리 이름이 지정된 경우 FindAssembliesByName 메서드는 어셈블리 참조를 확인하기 위한 표준 규칙에 따라 어셈블리를 찾습니다. FindAssembliesByName 을 사용하면 호출자가 애플리케이션 기반 및 프라이빗 검색 경로와 같은 어셈블리 확인자 컨텍스트의 다양한 측면을 구성할 수 있습니다.
FindAssembliesByName 은 전달된 어셈블리 이름에 대한 어셈블리 매니페스트가 포함된 파일에 대한 IMetaDataImport 포인터를 반환합니다. 지정된 어셈블리 이름이 부분적으로만 지정된 경우(예: 버전이 포함되지 않은 경우) 여러 어셈블리가 반환될 수 있습니다.
FindAssembliesByName 은 컴파일 시간에 참조된 어셈블리를 찾으려고 시도하는 컴파일러에서 일반적으로 사용됩니다.
요구 사항
요구 사항 | 값 |
---|---|
대상 플랫폼 | Windows |
헤더 | rometadataapi.h |