Compartir a través de

IHostIoCompletionManager::InitializeHostOverlapped (Método)

  • Artículo

Proporciona al host la oportunidad de inicializar los datos personalizados para anexar a una estructura Win32 OVERLAPPED que se usa para las solicitudes de E/S asincrónicas.

Sintaxis

HRESULT InitializeHostOverlapped (  
    [in] void* pvOverlapped  
);

Parámetros

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

Valor devuelto

HRESULT Descripción
S_OK InitializeHostOverlapped se devolvió correctamente.
HOST_E_CLRNOTAVAILABLE El Common Language Runtime (CLR) no se ha cargado en un proceso o se encuentra en un estado en el que no puede ejecutar 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 autor de la llamada no es el propietario del bloqueo.
HOST_E_ABANDONED Se canceló un evento mientras que una fibra o subproceso que estaba bloqueado lo estaba esperando.
E_FAIL Ocurrió un error grave desconocido. Si un método devuelve el valor E_FAIL, el CLR ya no se podrá usar en el proceso. Las llamadas que se hagan a los métodos de hospedaje posteriormente devolverán el valor HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY No había suficiente memoria disponible para asignar el recurso solicitado.

Comentarios

Las funciones de la Plataforma Windows usan la estructura para almacenar el OVERLAPPED 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 OVERLAPPED.

Importante

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

Un valor devuelto de E_OUTOFMEMORY indica que el host no ha podido inicializar sus datos personalizados. En este caso, CLR notifica un error y produce un error en la llamada.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: MSCorEE.h

Biblioteca: incluida como recurso en MSCorEE.dll

Versiones de .NET Framework: disponible a partir de la versión 2.0

Consulte también