IHostIoCompletionManager::InitializeHostOverlapped-Methode

Artikel
08/10/2011

Ermöglicht dem Host, benutzerdefinierte Daten zu initialisieren, um diese an eine Win32-OVERLAPPED-Struktur anzufügen, die für asynchrone E/A-Anforderungen verwendet wird.

HRESULT InitializeHostOverlapped (
    [in] void* pvOverlapped
);

Parameter

pvOverlapped
[in] Ein Zeiger auf die Win32-OVERLAPPED-Struktur, die in die E/A-Anforderung eingeschlossen werden soll.

Rückgabewert

HRESULT	Beschreibungen
S_OK	InitializeHostOverlapped erfolgreich zurückgegeben.
HOST_E_CLRNOTAVAILABLE	Die Common Language Runtime (CLR) wurde nicht in einen Prozess geladen oder befindet sich in einem Zustand, in dem sie weder verwalteten Code ausführen noch den Aufruf erfolgreich verarbeiten kann.
HOST_E_TIMEOUT	Der Aufruf hat das Zeitlimit überschritten.
HOST_E_NOT_OWNER	Der Aufrufer ist nicht Besitzer der Sperre.
HOST_E_ABANDONED	Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber auf das Ereignis gewartet hat.
E_FAIL	Ein unbekannter, schwerwiegender Fehler ist aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die CLR innerhalb des Prozesses nicht mehr verwendet werden. Nachfolgende Aufrufe von Hostmethoden geben HOST_E_CLRNOTAVAILABLE zurück.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher verfügbar, um die angeforderte Ressource zuzuordnen.

Hinweise

Die Funktionen der Windows-Plattform verwenden die OVERLAPPED-Struktur, um den Zustand für asynchrone E/A-Anforderungen zu speichern. Die CLR ruft die InitializeHostOverlapped-Methode auf, um dem Host das Anfügen von benutzerdefinierten Daten an eine OVERLAPPED-Instanz zu ermöglichen.

Wichtig
Um an den Anfang des benutzerdefinierten Datenblocks zu gelangen, müssen Hosts den Offset auf die Größe der OVERLAPPED-Struktur festlegen (sizeof(OVERLAPPED)).

Der Rückgabewert E_OUTOFMEMORY gibt an, dass beim Initialisieren der benutzerdefinierten Daten durch den Host ein Fehler aufgetreten ist. In diesem Fall meldet die CLR einen Fehler, und der Aufruf schlägt fehl.