IHostIoCompletionManager::InitializeHostOverlapped (Método)
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
