Método de ICLRAssemblyIdentityManager::GetBindingIdentityFromFile

Artigo
08/08/2011

Obtém a identidade do assembly a vinculação de dados para o assembly no caminho de arquivo especificado.

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 avaliada.
dwFlags
[in] Um valor igual a ECLRAssemblyIdentityFlags enumeração que indica o tipo de identidade do assembly. Fornecido para futura extensibilidade. CLR_ASSEMBLY_IDENTITY_FLAGS_DEFAULT é o único valor, o common language runtime (CLR) versão 2.0 oferece suporte.
pwzBuffer
[out] Um buffer que contém os dados de identidade do assembly opaco.
pcchBufferSize
[in, out] Um ponteiro para o tamanho do pwzBuffer.

Valor de retorno

HRESULT	Descrição
S_OK	O método retornou com êxito.
E_INVALIDARG	Fornecido pwzFilePath é null.
ERROR_INSUFFICIENT_BUFFER	O tamanho do pwzBuffer é muito pequeno.
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

GetBindingIdentityFromFilenormalmente é 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 apropriadamente e o método retorna com os dados reais do buffer após a conclusão.