Método IMetaDataAssemblyImport::FindAssembliesByName

Artigo
05/10/2023

Obtém uma matriz de assemblagens com o parâmetro especificado szAssemblyName , utilizando as regras padrão utilizadas pelo runtime de linguagem comum (CLR) 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

szAppBase
[in] O diretório de raiz no qual pretende procurar a assemblagem especificada. Se este valor estiver definido como null, FindAssembliesByName irá procurar apenas na cache de assemblagem global da assemblagem.

szPrivateBin
[in] Uma lista de subdiretórios delimitados por ponto e vírgula (por exemplo, "bin;bin2"), no diretório raiz, no qual pretende procurar a assemblagem. Estes diretórios são sondados para além dos especificados nas regras de pesquisa predefinidas.

szAssemblyName
[in] O nome da assemblagem a localizar. O formato desta cadeia é definido na página de referência de classe para AssemblyName.

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

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

pcAssemblies
[fora] O número de ponteiros de interface devolvidos, ou seja, o número de ponteiros de interface realmente colocados em ppIUnk.

Devolver Valor

HRESULT	Description
`S_OK`	`FindAssembliesByName` devolvido com êxito.
`S_FALSE`	Não existem assemblagens.

Observações

Tendo em conta um nome de assemblagem, o FindAssembliesByName método localiza a assemblagem ao seguir as regras padrão para resolver referências de assemblagem. (Para obter mais informações, consulte Como o Runtime Localiza Assemblagens.) FindAssembliesByName permite que o autor da chamada configure vários aspetos do contexto de resolução de assemblagem, como a base de aplicações e o caminho de pesquisa privado.

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

FindAssembliesByName devolve um ponteiro IMetaDataImport para o ficheiro que contém o manifesto de assemblagem para o nome da assemblagem que é transmitido. Se o nome da assemblagem especificado não estiver totalmente especificado (por exemplo, se não incluir uma versão), poderão ser devolvidas várias assemblagens.

FindAssembliesByName é normalmente utilizado por um compilador que tenta encontrar uma assemblagem referenciada no momento da compilação.

Requisitos

Plataformas: Veja Requisitos do Sistema.

Cabeçalho: Cor.h

Biblioteca: Utilizado como recurso no MsCorEE.dll

.NET Framework Versões: Disponível desde 1.0

Partilhar via