IMetaDataAssemblyImport::FindAssembliesByName — Metoda
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ń.
Składnia
HRESULT FindAssembliesByName (
[in] LPCWSTR szAppBase,
[in] LPCWSTR szPrivateBin,
[in] LPCWSTR szAssemblyName,
[out] IUnknown *ppIUnk[],
[in] ULONG cMax,
[out] ULONG *pcAssemblies
);
Parametry
szAppBase
[in] Katalog główny, w którym ma być wyszukiwany dany zestaw. Jeśli ta wartość jest ustawiona na nullwartość , FindAssembliesByName będzie wyglądać tylko w globalnej pamięci podręcznej zestawów dla zestawu.
szPrivateBin
[in] Lista podkatalogów rozdzielanych średnikami (na przykład "bin;bin2") w katalogu głównym, w którym należy wyszukać zestaw. Te katalogi są sondowane oprócz katalogów 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 .ppIUnk
pcAssemblies
[out] Liczba zwróconych wskaźników interfejsu — czyli liczba wskaźników interfejsu w rzeczywistości umieszczonych w elemecie ppIUnk.
Wartość zwracana
| HRESULT | Opis |
|---|---|
S_OK |
FindAssembliesByName zwrócone pomyślnie. |
S_FALSE |
Brak zestawów. |
Uwagi
Biorąc pod uwagę nazwę zestawu, FindAssembliesByName metoda znajduje zestaw, postępując zgodnie ze standardowymi regułami rozpoznawania odwołań do zestawów. (Aby uzyskać więcej informacji, zobacz Jak środowisko uruchomieniowe lokalizuje zestawy). FindAssembliesByName umożliwia wywołującym konfigurowanie 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 zestawów. W związku z tym przed wywołaniem FindAssembliesByNamemetody należy wywołać metodę CoInitializeEEE (przekazywanie COINITEE_DEFAULT), 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.
Wymagania
Platformy: Zobacz Wymagania systemowe.
Nagłówka: Cor.h
Biblioteki: Używane jako zasób w MsCorEE.dll
wersje .NET Framework: dostępne od wersji 1.0
