Méthode IMetaDataAssemblyImport ::FindAssembliesByName (rometadataapi.h)

Article
03/01/2024

Obtient un tableau d’assemblys portant le nom spécifié, à l’aide des règles standard utilisées par le Common Language Runtime (CLR) pour la résolution des références.

Syntaxe

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

Paramètres

[in] szAppBase

Répertoire racine dans lequel rechercher l’assembly donné. Si cette valeur est définie sur null, FindAssembliesByName recherche uniquement l’assembly dans le global assembly cache.

[in] szPrivateBin

Liste de sous-répertoires délimités par des points-virgules (par exemple, « bin ; bin2 »), sous le répertoire racine, dans lequel rechercher l’assembly. Ces répertoires sont sondés en plus de ceux spécifiés dans les règles de sondage par défaut.

[in] szAssemblyName

Nom de l’assembly à rechercher. Le format de cette chaîne est défini dans la page de référence de classe pour AssemblyName.

[out] ppIUnk

Tableau de type IUnknown dans lequel placer les pointeurs d’interface IMetadataAssemblyImport .

[in] cMax

Nombre maximal de pointeurs d’interface pouvant être placés dans ppIUnk.

[out] pcAssemblies

Nombre de pointeurs d’interface retournés. Autrement dit, le nombre de pointeurs d’interface réellement placés dans ppIUnk.

Valeur retournée

HRESULT	Description
S_OK	FindAssembliesByName retourné avec succès.
S_FALSE	Il n’existe aucun assembly.

Notes

Avec un nom d’assembly, la méthode FindAssembliesByName recherche l’assembly en suivant les règles standard de résolution des références d’assembly. FindAssembliesByName permet à l’appelant de configurer différents aspects du contexte du programme de résolution d’assembly, tels que la base d’application et le chemin de recherche privé.

FindAssembliesByName renvoie un pointeur IMetaDataImport vers le fichier contenant le manifeste de l’assembly pour le nom de l’assembly passé. Si le nom d’assembly donné n’est pas complètement spécifié (par exemple, s’il n’inclut pas de version), plusieurs assemblys peuvent être retournés.

FindAssembliesByName est couramment utilisé par un compilateur qui tente de trouver un assembly référencé au moment de la compilation.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	rometadataapi.h

Voir aussi

IMetaDataAssemblyImport

Partager via