Método IMetaDataAssemblyImport::FindAssembliesByName

Artigo
08/25/2010

Obtém uma matriz de assemblies com o especificado szAssemblyName parâmetro, usando as regras padrão empregadas pelo common linguagem tempo de execução (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 para Pesquisar do assembly fornecido. Se esse valor for definido como null, FindAssembliesByName irá procurar somente na cache global de assemblies para o assembly.
szPrivateBin
[in] Uma lista de subdiretórios separados por ponto-e-vírgula (por exemplo, "compartimento; bin2"), sob o diretório raiz no qual deseja procurar o assembly. Esses diretórios são analisados juntamente com aquelas especificadas no padrão de regras de probing.
szAssemblyName
[in] O nome do assembly para encontrar. O formato dessa seqüência de caracteres é definido na página de referência de classe de AssemblyName.
ppIUnk
[in] Uma matriz do tipo IUnknown no qual deseja colocar o IMetadataAssemblyImport ponteiros de interface.
cMax
[out] O número máximo de ponteiros de interface que pode ser colocado em ppIUnk.
pcAssemblies
[out] O número de ponteiros de interface retornada. Ou seja, o número de ponteiros de interface, na verdade, colocada em ppIUnk.

Valor de retorno

HRESULT	Descrição
S_OK	FindAssembliesByName retornado com êxito.
S_FALSE	Não há nenhum assemblies.

Comentários

Recebe um nome de assembly, a FindAssembliesByName método encontra 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 para configurar sistema autônomo vários aspectos do contexto de resolvedor de assembly, sistema autônomo caminho de Pesquisar básica e particulares de aplicativo.

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

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

FindAssembliesByName costuma ser usado por um compilador tenta localizar um assembly referenciado em time de compilar.

Requisitos

Plataformas: See Requisitos de sistema do .NET framework.

Cabeçalho: Cor.h

Biblioteca: Usado sistema autônomo um recurso em MsCorEE.dll

.NET Framework Versions: 3.5 SP1, 3,5, 3.0 SP1, 3.0, 2.0 SP1, 2.0, 1.1, 1.0

Consulte também

Conceitos

Como o Runtime Localiza Assemblies

Referência

Interface IMetaDataAssemblyImport

Partilhar via