IMetaDataAssemblyImport::FindAssembliesByName – metoda

Článek
05/10/2023

Získá pole sestavení se zadaným szAssemblyName parametrem pomocí standardních pravidel používaných common language runtime (CLR) pro překlad odkazů.

Syntaxe

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

Parametry

szAppBase
[v] Kořenový adresář, ve kterém se má vyhledat dané sestavení. Pokud je tato hodnota nastavená na nullhodnotu , FindAssembliesByName bude pro sestavení vypadat pouze v globální mezipaměti sestavení .

szPrivateBin
[v] Seznam podadresářů oddělených středníkem (například "bin;bin2") v kořenovém adresáři, ve kterém se má vyhledat sestavení. Tyto adresáře se probádají kromě adresářů zadaných ve výchozích pravidlech sondování.

szAssemblyName
[v] Název sestavení, které se má najít. Formát tohoto řetězce je definován na stránce odkazu na třídu pro AssemblyName.

ppIUnk
[out] Pole, které obsahuje IMetadataAssemblyImport ukazatele rozhraní.

cMax
[v] Maximální počet ukazatelů rozhraní, které se mají umístit ppIUnkdo .

pcAssemblies
[out] Počet vrácených ukazatelů rozhraní – to znamená počet skutečně umístěných ukazatelů rozhraní v ppIUnknástroji .

Návratová hodnota

HRESULT	Description
`S_OK`	`FindAssembliesByName` úspěšně vráceno.
`S_FALSE`	Neexistují žádná sestavení.

Poznámky

Vzhledem k názvu FindAssembliesByName sestavení metoda vyhledá sestavení podle standardních pravidel pro překlad odkazů na sestavení. (Další informace najdete v tématu Jak modul runtime vyhledává sestavení.) FindAssembliesByName umožňuje volajícímu konfigurovat různé aspekty kontextu překladače sestavení, jako je základní aplikace a cesta privátního vyhledávání.

Metoda FindAssembliesByName vyžaduje, aby byl v procesu inicializován modul CLR, aby bylo možné vyvolat logiku řešení sestavení. Proto musíte před voláním FindAssembliesByNamevolat CoInitializeEE (předávání COINITEE_DEFAULT) a pak následovat s voláním CoUninitializeCor.

FindAssembliesByName vrátí ukazatel IMetaDataImport na soubor obsahující manifest sestavení pro název sestavení, který je předán. Pokud zadaný název sestavení není plně zadaný (například pokud neobsahuje verzi), může být vráceno více sestavení.

FindAssembliesByName je běžně používán kompilátorem, který se pokouší najít odkazované sestavení v době kompilace.

Požadavky

Platformy: Viz Požadavky na systém.

Záhlaví: Kor.h

Knihovny: Používá se jako prostředek v MsCorEE.dll

Verze rozhraní .NET Framework: K dispozici od verze 1.0

Sdílet prostřednictvím