Methode IHostIoCompletionManager::GetHostOverlappedSize
Hiermee haalt u de grootte op van alle aangepaste gegevens die de host wil toevoegen aan I/O-aanvragen.
Syntaxis
HRESULT GetHostOverlappedSize (
[out] DWORD *pcbSize
);
Parameters
pcbSize
[uit] Een verwijzing naar het aantal bytes dat de Common Language Runtime (CLR) moet toewijzen naast de grootte van het Win32-object OVERLAPPED .
Retourwaarde
| HRESULT | Beschrijving |
|---|---|
| S_OK | GetHostOverlappedSize is geretourneerd. |
| HOST_E_CLRNOTAVAILABLE | De CLR is niet geladen in een proces of de CLR heeft 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 slot. |
| HOST_E_ABANDONED | Een gebeurtenis is geannuleerd terwijl er een geblokkeerde thread of glasvezel op wachtte. |
| E_FAIL | Er is een onbekende catastrofale fout opgetreden. Wanneer een methode E_FAIL retourneert, is de CLR niet meer bruikbaar binnen het proces. Volgende aanroepen naar hostingmethoden retourneren HOST_E_CLRNOTAVAILABLE. |
Opmerkingen
Alle asynchrone I/O-aanroepen naar Windows-platform-API's nemen een Win32-object OVERLAPPED op, dat informatie biedt, zoals de positie van de bestandspointer. Om de status te behouden, voegen toepassingen die asynchrone I/O-aanroepen maken meestal aangepaste gegevens toe aan de structuur. GetHostOverlappedSize en IHostIoCompletionManager::InitializeHostOverlapped bieden de host de mogelijkheid om dergelijke aangepaste gegevens op te nemen.
De CLR roept de GetHostOverlappedSize methode aan om de grootte te bepalen van de aangepaste gegevens die de host aan het OVERLAPPED object wil toevoegen.
Notitie
GetHostOverlappedSize wordt slechts eenmaal aangeroepen. De aangepaste gegevens van de host moeten dezelfde grootte hebben voor elke I/O-aanvraag.
Belangrijk
De grootte van het OVERLAPPED object zelf is niet opgenomen in de waarde van pcbSize.
Zie de documentatie voor het OVERLAPPED Windows-platform voor meer informatie over de structuur.
Vereisten
Platforms: Zie Systeemvereisten.
Header: MSCorEE.h
Bibliotheek: Opgenomen als een resource in MSCorEE.dll
.NET Framework versies: beschikbaar sinds 2.0
