Método IHostIoCompletionManager::InitializeHostOverlapped

Artigo
08/25/2010

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íncrono.

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 E/s.

Valor de retorno

HRESULT	Descrição
S_OK	InitializeHostOverlapped retornado com êxito.
HOST_E_CLRNOTAVAILABLE	O common linguagem tempo de execução (CLR) não foi carregado em um processo ou o CLR está em um estado em que ele não possa executar código gerenciado ou processar a telefonar com êxito.
HOST_E_TIMEOUT	A telefonar expirou.
HOST_E_NOT_OWNER	O chamador não é proprietário do bloquear.
HOST_E_ABANDONED	Um evento foi cancelado enquanto um segmento bloqueado ou fibra estava aguardando nele.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR não é mais útil dentro do processo. As chamadas subseqüentes à hospedagem métodos retornam HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY	Não há memória suficiente insuficiente alocar o recurso solicitado.

Comentários

As funções da plataforma Windows usarem o OVERLAPPED estrutura para armazenar o estado para solicitações de E/s assíncrono. O CLR chama o InitializeHostOverlapped método para atribuir a oportunidade de acrescentar dados personalizados para o host de um OVERLAPPED instância.

Observação importante:
Para obter o início do seu bloco de dados personalizados, hosts devem conjunto o deslocamento para o dimensionar das OVERLAPPED () estruturasizeof(OVERLAPPED)).

Um valor retornado do E_OUTOFMEMORY indica que o host falhou ao inicializar seus dados personalizados. Nesse caso, o CLR reporta um erro e a telefonar falhará.