IMetaDataAssemblyImport::FindAssembliesByName Method

Pobiera tablicę zestawów z określonym szAssemblyName parametrem przy użyciu standardowych reguł stosowanych przez środowisko uruchomieniowe języka wspólnego (CLR) do rozpoznawania odwołań.

Syntax

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

Parameters

szAppBase [in] Katalog główny, w którym należy wyszukać dany zestaw. Jeśli ta wartość jest ustawiona na null, FindAssembliesByName będzie wyglądać tylko w globalnej pamięci podręcznej zestawów dla zestawu.

szPrivateBin [in] Lista podkatalogów rozdzielonych średnikami (na przykład "bin; bin2"), w katalogu głównym, w którym należy wyszukać zestaw. Te katalogi są sondowane oprócz tych określonych w domyślnych regułach sondowania.

szAssemblyName [in] Nazwa zestawu do znalezienia. Format tego ciągu jest zdefiniowany na stronie odwołania do klasy dla elementu AssemblyName.

ppIUnk [out] Tablica zawierająca wskaźniki interfejsu IMetadataAssemblyImport .

cMax [in] Maksymalna liczba wskaźników interfejsu do umieszczenia w pliku ppIUnk.

pcAssemblies [out] Liczba zwróconych wskaźników interfejsu — czyli liczba wskaźników interfejsu w rzeczywistości umieszczonych w elemecie ppIUnk.

Return Value

Remarks

Biorąc pod uwagę nazwę zestawu, FindAssembliesByName metoda znajduje zestaw, postępując zgodnie ze standardowymi regułami rozwiązywania odwołań do zestawów. (Aby uzyskać więcej informacji, zobacz Jak środowisko uruchomieniowe lokalizuje zestawy). FindAssembliesByName umożliwia wywołującym skonfigurowanie różnych aspektów kontekstu rozpoznawania zestawów, takich jak baza aplikacji i prywatna ścieżka wyszukiwania.

Metoda FindAssembliesByName wymaga zainicjowania środowiska CLR w procesie w celu wywołania logiki rozpoznawania zestawu. W związku z tym należy wywołać metodę CoInitializeEE ( przekazywanie COINITEE_DEFAULT) przed wywołaniem FindAssembliesByNamemetody , a następnie wykonać wywołanie metody CoUninitializeCor.

FindAssembliesByName Zwraca wskaźnik IMetaDataImport do pliku zawierającego manifest zestawu dla przekazanej nazwy zestawu. Jeśli podana nazwa zestawu nie jest w pełni określona (na przykład jeśli nie zawiera wersji), może zostać zwróconych wiele zestawów.

FindAssembliesByName jest często używany przez kompilator, który próbuje znaleźć przywoływał zestaw w czasie kompilacji.

Requirements

Platformy: Zobacz Obsługiwane systemy operacyjne platformy .NET.

Header: Cor.h

Library: CorGuids.lib

See also

• jak środowisko uruchomieniowe lokalizuje zestawy
• IMetaDataAssemblyImport Interface