Método IMetaDataAssemblyImport::FindAssembliesByName (rometadataapi.h)
Obtém uma matriz de assemblies com o nome especificado, usando as regras padrão empregadas pelo CLR (Common Language Runtime) para resolver referências.
Sintaxe
HRESULT FindAssembliesByName(
[in] LPCWSTR szAppBase,
[in] LPCWSTR szPrivateBin,
[in] LPCWSTR szAssemblyName,
[out] IUnknown * [] ppIUnk,
[in] ULONG cMax,
[out] ULONG *pcAssemblies
);
Parâmetros
[in] szAppBase
O diretório raiz no qual pesquisar o assembly fornecido. Se esse valor for definido como nulo, FindAssembliesByName procurará apenas no cache de assembly global do assembly.
[in] szPrivateBin
Uma lista de subdiretórios delimitados por ponto e vírgula (por exemplo, "bin; bin2"), no diretório raiz, no qual pesquisar o assembly. Esses diretórios são investigados além daqueles especificados nas regras de investigação padrão.
[in] szAssemblyName
O nome do assembly a ser localizado. O formato dessa cadeia de caracteres é definido na página de referência de classe para AssemblyName.
[out] ppIUnk
Uma matriz do tipo IUnknown na qual colocar os ponteiros da interface IMetadataAssemblyImport .
[in] cMax
O número máximo de ponteiros de interface que podem ser colocados em ppIUnk.
[out] pcAssemblies
O número de ponteiros de interface retornados. Ou seja, o número de ponteiros de interface realmente colocados em ppIUnk.
Retornar valor
| HRESULT | Descrição |
|---|---|
| S_OK | FindAssembliesByName retornou com êxito. |
| S_FALSE | Não há assemblies. |
Comentários
Dado um nome de assembly, o método FindAssembliesByName localiza o assembly seguindo as regras padrão para resolver referências de assembly. FindAssembliesByName permite que o chamador configure vários aspectos do contexto do resolvedor de assembly, como base de aplicativo e caminho de pesquisa privado.
FindAssembliesByName retorna um ponteiro IMetaDataImport para o arquivo que contém o manifesto do assembly para o nome do assembly que é passado. Se o nome do assembly fornecido não estiver totalmente especificado (por exemplo, se ele não incluir uma versão), vários assemblies poderão ser retornados.
FindAssembliesByName é comumente usado por um compilador que tenta localizar um assembly referenciado em tempo de compilação.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | rometadataapi.h |