IMetaDataAssemblyImport::FindAssembliesByName-Methode (rometadataapi.h)

Ruft ein Array von Assemblys mit dem angegebenen Namen unter Verwendung der Standardregeln ab, die von der Common Language Runtime (CLR) zum Auflösen von Verweisen verwendet werden.

Syntax

HRESULT FindAssembliesByName(
  [in]  LPCWSTR       szAppBase,
  [in]  LPCWSTR       szPrivateBin,
  [in]  LPCWSTR       szAssemblyName,
  [out] IUnknown * [] ppIUnk,
  [in]  ULONG         cMax,
  [out] ULONG         *pcAssemblies
);

Parameter

[in] szAppBase

Das Stammverzeichnis, in dem nach der angegebenen Assembly gesucht werden soll. Wenn dieser Wert auf NULL festgelegt ist, sucht FindAssembliesByName nur im globalen Assemblycache für die Assembly.

[in] szPrivateBin

Eine Liste von semikolonstrennten Unterverzeichnissen (z. B. "bin; bin2"), unter dem Stammverzeichnis, in dem nach der Assembly gesucht werden soll. Diese Verzeichnisse werden zusätzlich zu den in den Standardüberprüfungsregeln angegebenen Verzeichnissen überprüft.

[in] szAssemblyName

Der Name der zu suchenden Assembly. Das Format dieser Zeichenfolge wird auf der Klassenreferenzseite für AssemblyName definiert.

[out] ppIUnk

Ein Array vom Typ IUnknown, in dem die IMetadataAssemblyImport-Schnittstellenzeiger platziert werden sollen.

[in] cMax

Die maximale Anzahl von Schnittstellenzeigern, die in ppIUnk platziert werden können.

[out] pcAssemblies

Die Anzahl der zurückgegebenen Schnittstellenzeiger. Das heißt, die Anzahl der tatsächlich in ppIUnk platzierten Schnittstellenzeiger.

Rückgabewert

Bemerkungen

Bei einem Assemblynamen sucht die FindAssembliesByName-Methode die Assembly, indem sie die Standardregeln zum Auflösen von Assemblyverweisen folgt. FindAssembliesByName ermöglicht es dem Aufrufer, verschiedene Aspekte des Assemblylöserkontexts zu konfigurieren, z. B. die Anwendungsbasis und den privaten Suchpfad.

FindAssembliesByName gibt einen IMetaDataImport-Zeiger auf die Datei zurück, die das Assemblymanifest für den übergebenen Assemblynamen enthält. Wenn der angegebene Assemblyname nicht vollständig ist (z. B. wenn er keine Version enthält), werden möglicherweise mehrere Assemblys zurückgegeben.

FindAssembliesByName wird häufig von einem Compiler verwendet, der versucht, eine Assembly zu finden, auf die zur Kompilierzeit verwiesen wird.

Anforderungen

Weitere Informationen

Imetadataassemblyimport