Condividi tramite


Metodo IHostIoCompletionManager::InitializeHostOverlapped

Fornisce all'host l'opportunità di inizializzare tutti i dati personalizzati da aggiungere a una struttura Win32 OVERLAPPED usata per le richieste di I/O asincrone.

Sintassi

HRESULT InitializeHostOverlapped (  
    [in] void* pvOverlapped  
);  

Parametri

pvOverlapped
[in] Puntatore alla struttura Win32 OVERLAPPED da includere nella richiesta di I/O.

Valore restituito

HRESULT Descrizione
S_OK InitializeHostOverlapped restituito correttamente.
HOST_E_CLRNOTAVAILABLE Common Language Runtime (CLR) non è stato caricato in un processo oppure CLR si trova in uno stato in cui non è possibile eseguire codice gestito o elaborare correttamente la chiamata.
HOST_E_TIMEOUT Timeout della chiamata.
HOST_E_NOT_OWNER Il chiamante non possiede il blocco.
HOST_E_ABANDONED Un evento è stato annullato durante l'attesa di un thread o di una fibra bloccata.
E_FAIL Si è verificato un errore irreversibile sconosciuto. Quando un metodo restituisce E_FAIL, CLR non è più utilizzabile all'interno del processo. Le chiamate successive ai metodi di hosting restituiscono HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY Memoria insufficiente per allocare la risorsa richiesta.

Commenti

Le funzioni della piattaforma Windows usano la OVERLAPPED struttura per archiviare lo stato per le richieste di I/O asincrone. CLR chiama il metodo per offrire all'host InitializeHostOverlapped la possibilità di accodare dati personalizzati a un'istanza OVERLAPPED di .

Importante

Per accedere all'inizio del blocco di dati personalizzato, gli host devono impostare l'offset sulle dimensioni della OVERLAPPED struttura (sizeof(OVERLAPPED)).

Un valore restituito di E_OUTOFMEMORY indica che l'host non è riuscito a inizializzare i dati personalizzati. In questo caso, CLR segnala un errore e non riesce la chiamata.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MSCorEE.h

Libreria: Incluso come risorsa in MSCorEE.dll

Versioni di .NET Framework: Disponibile dalla versione 2.0

Vedi anche