Método de ICLRAssemblyIdentityManager::GetReferencedAssembliesFromFile

Artigo
08/08/2011

Obtém um ICLRReferenceAssemblyEnum instância que contém uma lista de assemblies referenciados pelo assembly no caminho de arquivo especificado.

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

Parâmetros

pwzFilePath
[in] O caminho para o assembly a ser avaliada.
dwFlags
[in] Fornecido para futura extensibilidade. CLR_ASSEMBLY_IDENTITY_FLAGS_DEFAULT é o único valor que suporta a versão atual do common language runtime (CLR).
pExcludeAssembliesList
[in] Um ponteiro para um ICLRAssemblyReferenceList o objeto que representa assemblies devem ser excluídos do ppReferenceEnum.
ppReferenceEnum
[out] Um ponteiro para o endereço de um ICLRReferenceAssemblyEnum objeto que contém dados de identidade do assembly para assemblies referenciados pelo assembly em pwzFilePath, excluir os assemblies representado por pExcludeAssembliesList.

Valor de retorno

HRESULT	Descrição
S_OK	O método retornou com êxito.
HOST_E_CLRNOTAVAILABLE	O CLR não foi carregado em um processo ou o CLR é em um estado em que ele não é possível executar código gerenciado ou processar a chamada com êxito.
HOST_E_TIMEOUT	A chamada foi esgotado.
HOST_E_NOT_OWNER	O chamador não possui o bloqueio.
HOST_E_ABANDONED	Um evento foi cancelado, enquanto um segmento bloqueado ou fibra estava esperando por ele.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Se um método retornar E_FAIL, o CLR não é usável dentro do processo. As chamadas subseqüentes para hospedar os métodos retornam HOST_E_CLRNOTAVAILABLE.

Comentários

O chamador pode optar por excluir um conjunto de referências assembly conhecidos da lista retornada. Esse conjunto é definido pela pExcludeAssembliesList parâmetro.