Método ICLRReferenceAssemblyEnum::Get

Artigo
05/10/2023

Obtém a identidade do assembly no índice fornecido.

Sintaxe

HRESULT Get (  
    [in] DWORD dwIndex,  
    [out, size_is(*pcchBufferSize)] LPWSTR pwzBuffer,  
    [in, out] DWORD *pcchBufferSize  
);

Parâmetros

dwIndex
[in] O índice baseado em zero da identidade do assembly a ser retornado.

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

pcchBufferSize
[in, out] O tamanho do buffer pwzBuffer.

Valor Retornado

HRESULT	Descrição
S_OK	`Get` retornado com êxito.
ERROR_INSUFFICIENT_BUFFER	`pwzBuffer` é pequeno demais.
ERROR_NO_MORE_ITEMS	A enumeração não contém mais itens.
HOST_E_CLRNOTAVAILABLE	O CLR (Common Language Runtime) não foi carregado em um processo ou está em um estado no qual não pode executar o código gerenciado ou processar a chamada com sucesso.
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

Get é chamado normalmente duas vezes. A primeira chamada fornece um valor nulo para pwzBuffer e define pcchBufferSize com o tamanho apropriado para pwzBuffer. A segunda chamada fornece um pwzBuffer de tamanho adequado e contém os dados de identidade do assembly canônico 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

Compartilhar via