Método ICLRAssemblyIdentityManager::GetReferencedAssembliesFromFile

Artigo
05/10/2023

Obtém uma instância ICLRReferenceAssemblyEnum que contém uma lista de assemblagens referenciadas pela assemblagem no caminho de ficheiro especificado.

Sintaxe

HRESULT GetReferencedAssembliesFromFile (  
    [in]  LPCWSTR pwzFilePath,  
    [in]  DWORD   dwFlags,  
    [in]  ICLRAssemblyReferenceList   *pExcludeAssembliesList,  
    [out] ICLRReferenceAssemblyEnum  **ppReferenceEnum  
);

Parâmetros

pwzFilePath
[in] O caminho para a assemblagem a ser avaliada.

dwFlags
[in] Fornecido para extensibilidade futura. CLR_ASSEMBLY_IDENTITY_FLAGS_DEFAULT é o único valor suportado pela versão atual do common language runtime (CLR).

pExcludeAssembliesList
[in] Um ponteiro para um objeto ICLRAssemblyReferenceList que representa assemblagens que devem ser excluídas de ppReferenceEnum.

ppReferenceEnum
[fora] Um ponteiro para o endereço de um ICLRReferenceAssemblyEnum objeto que contém dados de identidade de assemblagem para as assemblagens referenciadas pela assemblagem em pwzFilePath, excluindo as assemblagens representadas por pExcludeAssembliesList.

Devolver Valor

HRESULT	Description
S_OK	O método foi devolvido com êxito.
HOST_E_CLRNOTAVAILABLE	O CLR não foi carregado para um processo ou o CLR está num estado em que não pode executar o código gerido ou processar a chamada com êxito.
HOST_E_TIMEOUT	A chamada excedeu o limite de tempo.
HOST_E_NOT_OWNER	O autor da chamada não é o proprietário do bloqueio.
HOST_E_ABANDONED	Um evento foi cancelado enquanto um thread ou fibra bloqueado estava à espera.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Se um método devolver E_FAIL, o CLR deixará de ser utilizável no processo. As chamadas subsequentes para métodos de alojamento devolvem HOST_E_CLRNOTAVAILABLE.

Observações

O autor da chamada pode optar por excluir um conjunto de referências de assemblagem conhecidas da lista devolvida. Este conjunto é definido pelo pExcludeAssembliesList parâmetro .

Requisitos

Plataformas: Veja Requisitos de Sistema.

Cabeçalho: MSCorEE.h

Biblioteca: Incluído como um recurso no MSCorEE.dll

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

Partilhar via