IMetaDataAssemblyImport::FindAssembliesByName Method

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

Syntax

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

Parameters

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

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

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

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

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

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

Return Value

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

Remarks

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

Tato FindAssembliesByName metoda vyžaduje, aby modul CLR byl inicializován v procesu, aby bylo možné vyvolat logiku překladu sestavení. Proto je nutné před voláním volat FindAssembliesByNameCoInitializeEE (předávání COINITEE_DEFAULT) a poté 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.

Requirements

Platformy: Viz podporované operační systémy .NET.

Header: Cor.h

Library: CorGuids.lib

See also

  • Last updated on