Método de IHostIoCompletionManager::InitializeHostOverlapped

Artigo
08/08/2011

Fornece o host a oportunidade de inicializar quaisquer dados personalizados para acrescentar um Win32 OVERLAPPED estrutura que é usada para solicitações de e/S assíncrona.

HRESULT InitializeHostOverlapped (
    [in] void* pvOverlapped
);

Parâmetros

pvOverlapped
[in] Um ponteiro para o Win32 OVERLAPPED estrutura para ser incluído com a solicitação de i/O.

Valor de retorno

HRESULT	Descrição
S_OK	InitializeHostOverlappedretornado com êxito.
HOST_E_CLRNOTAVAILABLE	O common language runtime (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. Quando um método retorna E_FAIL, o CLR não é usável dentro do processo. As chamadas subseqüentes para hospedar os métodos retornam HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY	Não havia memória suficiente disponível para alocar o recurso solicitado.

Comentários

A plataforma Windows funciona o uso de OVERLAPPED estrutura para armazenar o estado para solicitações de e/S assíncrona. As chamadas CLR da InitializeHostOverlapped método para atribuir a oportunidade de acrescentar dados personalizados para o host um OVERLAPPED instância.

Importante
Para obter o início do seu bloco de dados personalizados, hosts devem definir o deslocamento para o tamanho da OVERLAPPED estrutura (sizeof(OVERLAPPED)).

Um valor de retorno de E_OUTOFMEMORY indica que o host falhou ao inicializar seus dados personalizados. Nesse caso, o CLR reporta um erro e a chamada de falha.