Metodo IHostIoCompletionManager::InitializeHostOverlapped

Articolo
08/11/2011

Consente all'host di inizializzare qualsiasi dato personalizzato da aggiungere alla fine di una struttura OVERLAPPED Win32 utilizzata per le richieste di I/O asincrone.

HRESULT InitializeHostOverlapped (
    [in] void* pvOverlapped
);

Parametri

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

Valore restituito

HRESULT	Oggetto di descrizione
S_OK	InitializeHostOverlapped ha restituito correttamente un valore.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime non è stato caricato in un processo oppure si trova in uno stato in cui non è possibile eseguire codice gestito né elaborare correttamente la chiamata.
HOST_E_TIMEOUT	Timeout della chiamata.
HOST_E_NOT_OWNER	Il chiamante non è il proprietario del blocco.
HOST_E_ABANDONED	Un evento è stato annullato mentre un thread o un fiber bloccato era in attesa di tale evento.
E_FAIL	Si è verificato un errore irreversibile sconosciuto. Se un metodo restituisce E_FAIL, CLR non sarà più utilizzabile all'interno del processo. Le chiamate successive ai metodi di hosting restituiranno HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY	Memoria insufficiente per l'allocazione della risorsa richiesta.

Note

Le funzioni della piattaforma Windows utilizzano la struttura OVERLAPPED per l'archiviazione dello stato delle richieste di I/O asincrone. CLR chiama il metodo InitializeHostOverlapped per consentire all'host di accodare i dati personalizzati a un'istanza di OVERLAPPED.

Importante
Per arrivare all'inizio del proprio blocco di dati personalizzato, gli host devono impostare l'offset sulla dimensione della struttura OVERLAPPED (sizeof(OVERLAPPED)).

Se il valore restituito è E_OUTOFMEMORY, significa che l'host non è riuscito a inizializzare i dati personalizzati. In questo caso CLR segnalerà un errore e non eseguirà la chiamata.