IMetaDataAssemblyImport::FindAssembliesByName Method

Obtém uma matriz de assemblies com o parâmetro especificado szAssemblyName , usando as regras padrão empregadas pelo Common Language Runtime (CLR) para resolver referências.

Syntax

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

Parameters

szAppBase [em] O diretório raiz no qual procurar o assembly determinado. Se esse valor for definido como null, FindAssembliesByName procurará apenas o assembly no cache de assembly global.

szPrivateBin [em] Uma lista de subdiretórios delimitados por ponto-e-vírgula (por exemplo, "bin; bin2"), sob o diretório raiz, no qual procurar o assembly. Esses diretórios são investigados além daqueles especificados nas regras de sondagem padrão.

szAssemblyName [em] O nome do assembly a ser encontrado. O formato dessa cadeia de caracteres é definido na página de referência de classe para AssemblyName.

ppIUnk [saídas] Uma matriz que contém os ponteiros da IMetadataAssemblyImport interface.

cMax [em] O número máximo de ponteiros de interface para colocar no ppIUnk.

pcAssemblies [saídas] O número de ponteiros de interface retornados, ou seja, o número de ponteiros de interface realmente colocados no ppIUnk.

Return Value

Remarks

Dado um nome de assembly, o FindAssembliesByName método localiza o assembly seguindo as regras padrão para resolver referências de assembly. (Para obter mais informações, consulte Como o tempo de execução localiza assemblies.) FindAssembliesByName Permite que o chamador configure vários aspetos do contexto do resolvedor de assembly, como a base do aplicativo e o caminho de pesquisa privada.

O FindAssembliesByName método requer que o CLR seja inicializado no processo para invocar a lógica de resolução do assembly. Portanto, você deve chamar CoInitializeEE (passando COINITEE_DEFAULT) antes de chamar FindAssembliesByNamee, em seguida, seguir com uma chamada para CoUninitializeCor.

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 for 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 encontrar um assembly referenciado em tempo de compilação.

Requirements

Plataformas: Consulte Sistemas operacionais suportados pelo .NET.

Header: Cor.h

Library: CorGuids.lib

See also

• Como o ambiente de execução localiza conjuntos
• IMetaDataAssemblyImport Interface