Compartilhar via


Método ICLRAssemblyIdentityManager::GetBindingIdentityFromFile

Obtém os dados de associação de identidade do assembly no caminho de arquivo especificado.

Sintaxe

HRESULT GetBindingIdentityFromFile(  
    [in] LPCWSTR     pwzFilePath,  
    [in] DWORD       dwFlags,  
    [out, size_is(*pcchBufferSize)] LPWSTR pwzBuffer,  
    [in, out] DWORD *pcchBufferSize  
);  

Parâmetros

pwzFilePath
[in] O caminho para o arquivo a ser avaliado.

dwFlags
[in] Um valor da enumeração ECLRAssemblyIdentityFlags que indica o tipo de identidade de um assembly. Fornecido para extensibilidade futura. CLR_ASSEMBLY_IDENTITY_FLAGS_DEFAULT é o único valor com suporte no CLR (Common Language Runtime) versão 2.0.

pwzBuffer
[out] Um buffer contendo os dados de identidade do assembly opaco.

pcchBufferSize
[in, out] Um ponteiro para o tamanho de pwzBuffer.

Valor Retornado

HRESULT Descrição
S_OK O método foi retornado com êxito.
E_INVALIDARG O pwzFilePath fornecido é nulo.
ERROR_INSUFFICIENT_BUFFER O tamanho de pwzBuffer é muito pequeno.
HOST_E_CLRNOTAVAILABLE O CLR não foi carregado em um processo, ou o CLR está em um estado no qual não pode executar código gerenciado ou processar a chamada com êxito.
HOST_E_TIMEOUT Uma chamada atingiu o tempo limite.
HOST_E_NOT_OWNER O chamador não possui o bloqueio.
HOST_E_ABANDONED Um evento foi cancelado enquanto uma fibra ou um thread bloqueado estava esperando por ele.
E_FAIL Uma falha catastrófica desconhecida ocorreu. Se um método retornar E_FAIL, o CLR não poderá mais ser utilizado no processo. Chamadas subsequentes para métodos de hospedagem retornam HOST_E_CLRNOTAVAILABLE.

Comentários

GetBindingIdentityFromFile normalmente é chamado duas vezes. A primeira chamada fornece um valor nulo para pwzBuffer, e o método retorna o tamanho apropriado em pcchBufferSize. A segunda chamada fornece um buffer alocado adequadamente, e o método é retornado com os dados de buffer reais após a conclusão.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: MSCorEE.h

Biblioteca: incluída como um recurso no MSCorEE.dll

Versões do .NET Framework: disponíveis desde 2.0

Confira também