Methode ICLRIoCompletionManager::OnComplete

Artikel
05/09/2023

Hiermee wordt aan de COMMON Language Runtime (CLR) de status van een I/O-aanvraag gemeld die is gedaan met behulp van een aanroep van de methode IHostIoCompletionManager::Bind .

Syntaxis

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

Parameters

dwErrorCode
[in] Een HRESULT-waarde die de status van de bindingsbewerking aangeeft.

S_OK geeft aan dat de bewerking is voltooid.
HOST_E_INTERRUPTED geeft aan dat de aanroep is beëindigd voordat deze is voltooid.
E_FAIL geeft aan dat er een onbekende, onherstelbare, onherstelbare fout is opgetreden.

NumberOfBytesTransferred
[in] Het aantal bytes dat is overgedragen tijdens de verwerking van de I/O-aanvraag.

pvOverlapped
[in] Een verwijzing naar de OVERLAPPED structuur die is doorgegeven aan de aanroep van de IHostIoCompletionManager::Bind methode.

Retourwaarde

HRESULT	Beschrijving
S_OK	`OnComplete` is geretourneerd.
HOST_E_CLRNOTAVAILABLE	De CLR is niet geladen in een proces of de CLR bevindt zich in een status waarin beheerde code niet kan worden uitgevoerd of de aanroep kan worden verwerkt.
HOST_E_TIMEOUT	Er is een time-out opgetreden voor het gesprek.
HOST_E_NOT_OWNER	De beller is niet de eigenaar van het vergrendelingsslot.
HOST_E_ABANDONED	Een gebeurtenis is geannuleerd terwijl er een geblokkeerde thread of vezel op wachtte.
E_FAIL	Er is een onbekende catastrofale fout opgetreden. Nadat een methode E_FAIL retourneert, is de CLR niet meer bruikbaar binnen het proces. Volgende aanroepen naar hostingmethoden retourneren HOST_E_CLRNOTAVAILABLE.

Opmerkingen

Als de host een I/O-voltooiingabstractie implementeert, doet de CLR I/O-aanvragen via de host met behulp van de methoden van IHostIoCompletionManager. De host roept vervolgens de OnComplete methode aan om de runtime op de hoogte te stellen van het resultaat van dergelijke aanvragen.

Vereisten

Platforms: Zie Systeemvereisten.

Header: MSCorEE.h

Bibliotheek: Opgenomen als een resource in MSCorEE.dll

.NET Framework versies: beschikbaar sinds 2.0

Delen via