Freigeben über

ICLRIoCompletionManager::OnComplete-Methode

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.

Siehe auch

  • Last updated on