Método de IHostIoCompletionManager::GetHostOverlappedSize

Artigo
08/08/2011

Obtém o tamanho de qualquer host pretende acrescentar às solicitações de i/O de dados personalizados.

HRESULT GetHostOverlappedSize (
    [out] DWORD *pcbSize
);

Parâmetros

pcbSize
[out] Um ponteiro para o número de bytes que o common language runtime (CLR) deve alocar além de para o tamanho do Win32 OVERLAPPED objeto.

Valor de retorno

HRESULT	Descrição
S_OK	GetHostOverlappedSizeretornado com êxito.
HOST_E_CLRNOTAVAILABLE	O 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.

Comentários

Todas as chamadas de e/S assíncronas para APIs de plataforma do Windows levar Win32 OVERLAPPED o objeto, que fornece informações como posição do ponteiro do arquivo. Para manter o estado, os aplicativos que fazem chamadas de e/S assíncronas normalmente adicionam dados personalizados na estrutura. GetHostOverlappedSizee IHostIoCompletionManager::InitializeHostOverlapped oferecem uma oportunidade para o host incluir esses dados personalizados.

As chamadas CLR a GetHostOverlappedSize método para determinar o tamanho dos dados personalizados que o host deve acrescentar a OVERLAPPED objeto.

Observação

GetHostOverlappedSizeé chamado somente uma vez.A dados personalizados do host devem ser do mesmo tamanho para cada solicitação de i/O.