Método ICLRAssemblyIdentityManager::GetBindingIdentityFromFile

Artigo
05/10/2023

Obtém os dados de enlace de identidade de assemblagem para a assemblagem no caminho de ficheiro 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 ficheiro a avaliar.

dwFlags
[in] Um valor da enumeração ECLRAssemblyIdentityFlags que indica o tipo de identidade de uma assemblagem. Fornecido para extensibilidade futura. CLR_ASSEMBLY_IDENTITY_FLAGS_DEFAULT é o único valor suportado pela versão 2.0 do runtime de linguagem comum (CLR).

pwzBuffer
[fora] Uma memória intermédia que contém os dados de identidade de assemblagem opacas.

pcchBufferSize
[dentro, fora] Um ponteiro para o tamanho de pwzBuffer.

Devolver Valor

HRESULT	Description
S_OK	O método foi devolvido com êxito.
E_INVALIDARG	O fornecido `pwzFilePath` é nulo.
ERROR_INSUFFICIENT_BUFFER	O tamanho de `pwzBuffer` é demasiado pequeno.
HOST_E_CLRNOTAVAILABLE	O CLR não foi carregado para um processo ou o CLR está num estado em que não pode executar 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 do mesmo.
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

GetBindingIdentityFromFile normalmente, é chamado duas vezes. A primeira chamada fornece um valor nulo para pwzBuffer, e o método devolve o tamanho adequado em pcchBufferSize. A segunda chamada fornece uma memória intermédia adequadamente alocada e o método devolve com os dados de memória intermédia reais após a conclusão.

Requisitos

Plataformas: Veja Requisitos do 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