Метод IMetaDataAssemblyImport::FindAssembliesByName (rometadataapi.h)
Возвращает массив сборок с указанным именем, используя стандартные правила, используемые средой CLR для разрешения ссылок.
Синтаксис
HRESULT FindAssembliesByName(
[in] LPCWSTR szAppBase,
[in] LPCWSTR szPrivateBin,
[in] LPCWSTR szAssemblyName,
[out] IUnknown * [] ppIUnk,
[in] ULONG cMax,
[out] ULONG *pcAssemblies
);
Параметры
[in] szAppBase
Корневой каталог, в котором выполняется поиск заданной сборки. Если для этого значения задано значение NULL, FindAssembliesByName будет искать только в глобальном кэше сборок для сборки.
[in] szPrivateBin
Список подкаталогов с разделителями точками с запятой (например, "bin; bin2"), в корневом каталоге, в котором выполняется поиск сборки. Эти каталоги пробуются в дополнение к каталогам, указанным в правилах проверки по умолчанию.
[in] szAssemblyName
Имя искать сборку. Формат этой строки определяется на странице справочника по классу для AssemblyName.
[out] ppIUnk
Массив типа IUnknown, в который помещают указатели интерфейса IMetadataAssemblyImport .
[in] cMax
Максимальное количество указателей интерфейса, которые можно поместить в ppIUnk.
[out] pcAssemblies
Количество возвращаемых указателей интерфейса. То есть количество указателей интерфейса, фактически помещенных в ppIUnk.
Возвращаемое значение
| HRESULT | Описание |
|---|---|
| S_OK | FindAssembliesByName успешно возвращен. |
| S_FALSE | Сборки отсутствуют. |
Комментарии
При указании имени сборки метод FindAssembliesByName находит сборку, следуя стандартным правилам разрешения ссылок на сборки. FindAssembliesByName позволяет вызывающей объекту настраивать различные аспекты контекста сопоставителя сборок, такие как база приложения и частный путь поиска.
FindAssembliesByName возвращает указатель IMetaDataImport на файл, содержащий манифест сборки для передаваемого имени сборки. Если имя сборки не указано полностью (например, если оно не содержит версию), может быть возвращено несколько сборок.
FindAssembliesByName обычно используется компилятором, который пытается найти сборку, на которую указывает ссылка, во время компиляции.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | rometadataapi.h |