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
