Método IHostIoCompletionManager::InitializeHostOverlapped
Proporciona ao anfitrião a oportunidade de inicializar quaisquer dados personalizados para acrescentar a uma estrutura Win32 OVERLAPPED que é utilizada para pedidos de E/S assíncronos.
Sintaxe
HRESULT InitializeHostOverlapped (
[in] void* pvOverlapped
);
Parâmetros
pvOverlapped
[in] Um ponteiro para a estrutura win32 OVERLAPPED a ser incluída com o pedido de E/S.
Devolver Valor
| HRESULT | Description |
|---|---|
| S_OK | InitializeHostOverlapped devolvido com êxito. |
| HOST_E_CLRNOTAVAILABLE | O runtime de linguagem comum (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. |
| E_FAIL | Ocorreu uma falha catastrófica desconhecida. Quando um método devolve E_FAIL, o CLR já não é utilizável no processo. As chamadas subsequentes para métodos de alojamento devolvem HOST_E_CLRNOTAVAILABLE. |
| E_OUTOFMEMORY | Não estava disponível memória suficiente para alocar o recurso pedido. |
Observações
As funções da Plataforma windows utilizam a estrutura para armazenar o OVERLAPPED estado para pedidos de E/S assíncronos. O CLR chama o InitializeHostOverlapped método para dar ao anfitrião a oportunidade de acrescentar dados personalizados a uma OVERLAPPED instância.
Importante
Para chegar ao início do respetivo bloco de dados personalizado, os anfitriões têm de definir o desvio para o tamanho da OVERLAPPED estrutura (sizeof(OVERLAPPED)).
Um valor devolvido de E_OUTOFMEMORY indica que o anfitrião não conseguiu inicializar os dados personalizados. Neste caso, o CLR comunica um erro e falha a chamada.
Requisitos
Plataformas: Veja Requisitos de Sistema.
Cabeçalho: MSCorEE.h
Biblioteca: Incluído como um recurso no MSCorEE.dll
.NET Framework Versões: Disponível desde 2.0
