Método IHostIoCompletionManager::GetHostOverlappedSize

Artigo
08/25/2010

Obtém o dimensionar de todos os dados personalizados host pretende acrescentar para solicitações de E/S.

HRESULT GetHostOverlappedSize (
    [out] DWORD *pcbSize
);

Parâmetros

pcbSize
[out] Um ponteiro para o número de bytes que o common linguagem tempo de execução (CLR) deve alocar em adição ao dimensionar do Win32 OVERLAPPED objeto.

Valor de retorno

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

Comentários

E/sistema autônomo assíncrono todas sistema autônomo chamadas para APIs da plataforma Windows levar um Win32 OVERLAPPED objeto, que fornece informações sistema autônomo a posição do ponteiro do arquivo. Para manter o estado, aplicativos que fazem chamadas de E/s assíncrono normalmente adicionar dados personalizados à estrutura. GetHostOverlappedSize e IHostIoCompletionManager::InitializeHostOverlapped oferecem uma oportunidade para o host incluir esses dados personalizados.

O CLR chama o GetHostOverlappedSize método para determinar o dimensionar dos dados personalizados que o host pretende anexar o OVERLAPPED objeto.