Compartilhar via

Método de IMetaDataAssemblyImport::FindAssembliesByName

  • Artigo

Obtém uma matriz de assemblies com o especificado szAssemblyName parâmetro, usando as regras padrão empregado pelo common language runtime (CLR) para resolver referências.

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

Parâmetros

  • szAppBase
    [in] O diretório raiz da pesquisa para o assembly fornecido. Se esse valor for definido como null, FindAssembliesByName aparecerá somente no cache global de assemblies para o assembly.

  • szPrivateBin
    [in] Uma lista de subdiretórios separados por ponto-e-vírgula (por exemplo, "bin; bin2"), sob o diretório raiz, na qual a pesquisa para o assembly. Esses diretórios serão investigados junto aos especificados no padrão de regras de probing.

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

  • ppIUnk
    [in] Uma matriz do tipo IUnknown no qual colocar a IMetadataAssemblyImport ponteiros de interface.

  • cMax
    [out] O número máximo de ponteiros de interface que pode ser colocado na ppIUnk.

  • pcAssemblies
    [out] O número de ponteiros de interface retornada. Ou seja, o número de ponteiros de interface realmente dispostos na ppIUnk.

Valor de retorno

HRESULT

Descrição

S_OK

FindAssembliesByNameretornado com êxito.

S_FALSE

Não há nenhum assemblies.

Comentários

Recebe 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 configurar vários aspectos do contexto de resolvedor assembly, como o caminho de pesquisa privados e de base do aplicativo

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

FindAssembliesByNameRetorna um IMetaDataImport o ponteiro para o arquivo que contém o manifesto do assembly para o nome do assembly, o que é passado. Se o nome do assembly fornecido não é totalmente especificado (por exemplo, se não tiver uma versão), vários assemblies podem ser retornados.

FindAssembliesByNameé normalmente usado por um compilador que tenta localizar um assembly referenciado em tempo de compilação.

Requisitos

Plataformas: Consulte Requisitos de sistema do .NET Framework.

Cabeçalho: Cor.h

Biblioteca: Usado como um recurso em mscoree

.NET Framework versões: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0, 1.1, 1.0

Consulte também

Referência

Interface de IMetaDataAssemblyImport

Conceitos

Como o Runtime Localiza Assemblies