Methode IHostIoCompletionManager::InitializeHostOverlapped
Biedt de host de mogelijkheid om aangepaste gegevens te initialiseren om toe te voegen aan een Win32-structuur OVERLAPPED die wordt gebruikt voor asynchrone I/O-aanvragen.
Syntaxis
HRESULT InitializeHostOverlapped (
[in] void* pvOverlapped
);
Parameters
pvOverlapped
[in] Een verwijzing naar de Win32-structuur OVERLAPPED die moet worden opgenomen in de I/O-aanvraag.
Retourwaarde
| HRESULT | Beschrijving |
|---|---|
| S_OK | InitializeHostOverlapped is geretourneerd. |
| HOST_E_CLRNOTAVAILABLE | De Common Language Runtime (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. Wanneer een methode E_FAIL retourneert, is de CLR niet meer bruikbaar binnen het proces. Volgende aanroepen naar hostingmethoden retourneren HOST_E_CLRNOTAVAILABLE. |
| E_OUTOFMEMORY | Er was onvoldoende geheugen beschikbaar om de aangevraagde resource toe te wijzen. |
Opmerkingen
De Functies van het Windows-platform gebruiken de structuur om de OVERLAPPED status op te slaan voor asynchrone I/O-aanvragen. De CLR roept de InitializeHostOverlapped methode aan om de host de mogelijkheid te geven om aangepaste gegevens toe te voegen aan een OVERLAPPED exemplaar.
Belangrijk
Om het begin van het aangepaste gegevensblok te bereiken, moeten hosts de offset instellen op de grootte van de OVERLAPPED structuur (sizeof(OVERLAPPED)).
Een retourwaarde van E_OUTOFMEMORY geeft aan dat de host de aangepaste gegevens niet heeft geïnitialiseerd. In dit geval meldt de CLR een fout en mislukt de aanroep.
Vereisten
Platforms: Zie Systeemvereisten.
Header: MSCorEE.h
Bibliotheek: Opgenomen als een resource in MSCorEE.dll
.NET Framework versies: beschikbaar sinds 2.0
