Megosztás:


IHostIoCompletionManager::InitializeHostOverlapped metódus

Lehetővé teszi a gazdagép számára, hogy inicializáljon minden egyéni adatot, hogy hozzáfűzzön egy Win32-struktúrához OVERLAPPED , amelyet aszinkron I/O-kérésekhez használnak.

Szintaxis

HRESULT InitializeHostOverlapped (  
    [in] void* pvOverlapped  
);  

Paraméterek

pvOverlapped
[in] Az I/O-kéréshez hozzáadni kívánt Win32-struktúrára OVERLAPPED mutató mutató.

Visszatérési érték

HRESULT Description
S_OK InitializeHostOverlapped sikeresen visszaadott.
HOST_E_CLRNOTAVAILABLE A közös nyelvi futtatókörnyezet (CLR) nincs betöltve egy folyamatba, vagy a CLR olyan állapotban van, amelyben nem tudja futtatni a felügyelt kódot, vagy nem tudja sikeresen feldolgozni a hívást.
HOST_E_TIMEOUT A hívás túllépte az időkorlátot.
HOST_E_NOT_OWNER A hívó nem rendelkezik a zárral.
HOST_E_ABANDONED Egy esemény megszakadt, miközben egy blokkolt szál vagy szál várakozott rá.
E_FAIL Ismeretlen katasztrofális hiba történt. Amikor egy metódus E_FAIL ad vissza, a CLR már nem használható a folyamaton belül. Az üzemeltetési módszerekre irányuló későbbi hívások HOST_E_CLRNOTAVAILABLE adnak vissza.
E_OUTOFMEMORY Nem volt elég memória a kért erőforrás lefoglalásához.

Megjegyzések

A Windows Platform függvényei a struktúrát használják az OVERLAPPED aszinkron I/O-kérések állapotának tárolására. A CLR meghívja a InitializeHostOverlapped metódust, hogy lehetőséget biztosítson a gazdagépnek arra, hogy egyéni adatokat fűzjön egy OVERLAPPED példányhoz.

Fontos

Az egyéni adatblokk elejéhez a gazdagépeknek a struktúrasizeof(OVERLAPPED) méretére () kell beállítaniuk az OVERLAPPED eltolást.

A E_OUTOFMEMORY visszatérési értéke azt jelzi, hogy a gazdagép nem tudta inicializálni az egyéni adatait. Ebben az esetben a CLR hibát jelez, és meghiúsul a hívás.

Követelmények

Platformok: Lásd: Rendszerkövetelmények.

Fejléc: MSCorEE.h

Könyvtár: Erőforrásként szerepel a MSCorEE.dll

.NET-keretrendszer verziók: 2.0 óta érhető el

Lásd még