다음을 통해 공유


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

추가 정보

IMetaDataAssemblyImport