ICLRIoCompletionManager::OnComplete-Methode

Artikel
06/05/2023

Benachrichtigt die Common Language Runtime (CLR) über den Status einer E/A-Anforderung, die mithilfe eines Aufrufs der IHostIoCompletionManager::Bind-Methode ausgeführt wurde

Syntax

HRESULT OnComplete (  
    [in] DWORD dwErrorCode,  
    [in] DWORD NumberOfBytesTransferred,  
    [in] void* pvOverlapped  
);

Parameter

dwErrorCode
[in] Ein HRESULT-Wert, der den Status des Bindungsvorgangs angibt

S_OK gibt an, dass der Vorgang erfolgreich abgeschlossen wurde.
HOST_E_INTERRUPTED gibt an, dass der Anruf vor Abschluss beendet wurde.
E_FAIL weist darauf hin, dass ein unbekannter, nicht behebbarer, katastrophaler Fehler aufgetreten ist.

NumberOfBytesTransferred
[in] Die Anzahl der Bytes, die während der Verarbeitung der E/A-Anforderung übertragen wurden

pvOverlapped
[in] Ein Zeiger auf die OVERLAPPED-Struktur, die an den Aufruf der IHostIoCompletionManager::Bind-Methode übergeben wurde.

Rückgabewert

HRESULT	BESCHREIBUNG
S_OK	`OnComplete` wurde erfolgreich zurückgegeben.
HOST_E_CLRNOTAVAILABLE	Die CLR wurde nicht in einen Prozess geladen, oder die CLR befindet sich in einem Zustand, in dem sie keinen verwalteten Code ausführen oder den Aufruf nicht erfolgreich verarbeiten kann.
HOST_E_TIMEOUT	Timeout des Aufrufs.
HOST_E_NOT_OWNER	Der Aufrufer besitzt die Sperre nicht.
HOST_E_ABANDONED	Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber darauf gewartet hat.
E_FAIL	Es ist ein unbekannter katastrophaler Fehler aufgetreten. Wenn eine Methode „E_FAIL“ zurückgibt, kann die CLR nicht mehr innerhalb des Prozesses verwendet werden. Nachfolgende Aufrufe von Hostingmethoden geben HOST_E_CLRNOTAVAILABLE zurück.

Bemerkungen

Wenn der Host eine E/A-Vervollständigungsabstraktion implementiert, sendet die CLR E/A-Anforderungen über den Host mithilfe von Methoden von IHostIoCompletionManager. Der Host ruft dann die OnComplete-Methode auf, um die Runtime des Ergebnisses solcher Anforderungen zu benachrichtigen.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: MSCorEE.h

Bibliothek: Als Ressource in „MsCorEE.dll“ enthalten.

.NET Framework-Versionen: Seit 2.0 verfügbar.

Freigeben über