Método ICLRProbingAssemblyEnum::Get
Obtém a identidade do assembly no índice especificado.
Sintaxe
HRESULT Get (
[in] DWORD dwIndex,
[out, size_is(*pcchBufferSize)] LPWSTR pwzBuffer,
[in, out] DWORD *pcchBufferSize
);
Parâmetros
dwIndex [em] O índice baseado em zero da identidade do assembly a ser retornado.
pwzBuffer [saiu] Um buffer que contém os dados de identidade do assembly.
pcchBufferSize [dentro, fora] O tamanho do pwzBuffer buffer.
Valor de retorno
| 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. Quando 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
A identidade no índice 0 é a identidade específica da arquitetura do processador. A identidade no índice 1 é o assembly de arquitetura neutra para linguagem intermediária comum (CIL). A identidade no índice 2 não contém nenhuma informação de arquitetura.
Get normalmente é chamado 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
