IMetaDataAssemblyImport::FindAssembliesByName Method

Obtém uma matriz de assemblies com o parâmetro especificado szAssemblyName , usando as regras padrão empregadas pelo CLR (Common Language Runtime) 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 [in] O diretório raiz no qual pesquisar o assembly fornecido. Se esse valor estiver definido como null, FindAssembliesByName será exibido apenas no cache de assembly global para o assembly.

szPrivateBin [in] 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.

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

ppIUnk [out] Uma matriz que contém os ponteiros da IMetadataAssemblyImport interface.

cMax[in] O número máximo de ponteiros de interface a serem colocados.ppIUnk

pcAssemblies [out] O número de ponteiros de interface retornados, ou seja, o número de ponteiros de interface realmente colocados em 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 Runtime localiza assemblies.) FindAssembliesByName permite que o chamador configure vários aspectos do contexto do resolvedor de assembly, como base de aplicativo e caminho de pesquisa privado.

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 geralmente é usado por um compilador que tenta localizar um assembly referenciado em tempo de compilação.

Requirements

Plataformas: Consulte sistemas operacionais com suporte do .NET.

Header: Cor.h

Library: CorGuids.lib

See also

• Como o runtime localiza assemblies
• IMetaDataAssemblyImport Interface