IHostIoCompletionManager::InitializeHostOverlapped (Método)

Artículo
08/10/2011

Ofrece al host la posibilidad de inicializar los datos personalizados para anexarlos a una estructura OVERLAPPED de Win32 empleada para las solicitudes de E/S asincrónicas.

HRESULT InitializeHostOverlapped (
    [in] void* pvOverlapped
);

Parámetros

pvOverlapped
[in] Puntero al principio de la estructura OVERLAPPED de Win32 que se va incluir con la solicitud de E/S.

Valor devuelto

HRESULT	Descripción
S_OK	InitializeHostOverlapped finalizó correctamente.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime (CLR) no se ha cargado en un proceso o está en un estado en el que no puede ejecutar el código administrado o procesar la llamada correctamente.
HOST_E_TIMEOUT	Se agotó el tiempo de espera de la llamada.
HOST_E_NOT_OWNER	El llamador no posee el bloqueo.
HOST_E_ABANDONED	Se canceló un evento mientras una fibra o un subproceso bloqueado estaba esperándole.
E_FAIL	Se ha producido un error catastrófico desconocido. Si un método devuelve E_FAIL, CLR no se puede seguir utilizando en el proceso. Las llamadas subsiguientes a métodos de hospedaje devuelven HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY	No había suficiente memoria disponible para asignar el recurso solicitado.

Comentarios

La plataforma Windows utiliza la estructura OVERLAPPED para almacenar el estado de las solicitudes de E/S asincrónicas. CLR llama al método InitializeHostOverlapped para dar al host la oportunidad de anexar datos personalizados a una instancia de OVERLAPPED.

Importante
Para llegar al principio del bloque de datos personalizado, los hosts deben establecer el desplazamiento en el tamaño de la estructura OVERLAPPED (sizeof(OVERLAPPED)).

Si se devuelve un valor de E_OUTOFMEMORY, significa que el host no ha podido inicializar sus datos personalizados. En este caso, CLR notifica un error y no podrá realizar la llamada.