Metodo IMetaDataAssemblyImport::FindAssembliesByName (rometadataapi.h)

Articolo
03/09/2024

Ottiene una matrice di assembly con il nome specificato, usando le regole standard usate da Common Language Runtime (CLR) per la risoluzione dei riferimenti.

Sintassi

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

Parametri

[in] szAppBase

Directory radice in cui cercare l'assembly specificato. Se questo valore è impostato su Null, FindAssembliesByName verrà visualizzato solo nella global assembly cache per l'assembly.

[in] szPrivateBin

Elenco di sottodirectory delimitate da punti e virgola, ad esempio "bin; bin2"), nella directory radice, in cui cercare l'assembly. Queste directory vengono probete oltre a quelle specificate nelle regole di prova predefinite.

[in] szAssemblyName

Nome dell'assembly da trovare. Il formato di questa stringa viene definito nella pagina di riferimento della classe per AssemblyName.

[out] ppIUnk

Matrice di tipo IUnknown in cui inserire i puntatori di interfaccia IMetadataAssemblyImport .

[in] cMax

Numero massimo di puntatori di interfaccia che possono essere posizionati in ppIUnk.

[out] pcAssemblies

Numero di puntatori di interfaccia restituiti. Vale a dire il numero di puntatori di interfaccia effettivamente inseriti in ppIUnk.

Valore restituito

HRESULT	Descrizione
S_OK	FindAssembliesByName restituito correttamente.
S_FALSE	Non sono presenti assembly.

Commenti

Dato un nome di assembly, il metodo FindAssembliesByName trova l'assembly seguendo le regole standard per la risoluzione dei riferimenti all'assembly. FindAssembliesByName consente al chiamante di configurare vari aspetti del contesto del resolver dell'assembly, ad esempio la base dell'applicazione e il percorso di ricerca privato.

FindAssembliesByName restituisce un puntatore IMetaDataImport al file contenente il manifesto dell'assembly per il nome dell'assembly passato. Se il nome dell'assembly specificato non viene specificato completamente, ad esempio se non include una versione, è possibile che vengano restituiti più assembly.

FindAssembliesByName viene comunemente usato da un compilatore che tenta di trovare un assembly a cui si fa riferimento in fase di compilazione.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	rometadataapi.h

Vedi anche

IMetaDataAssemblyImport

Condividi tramite