IHostIoCompletionManager::InitializeHostOverlapped (Método)

Actualización: noviembre 2007

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 se devolvió 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 irrecuperable desconocido. Cuando 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.

Nota 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.