IHostIoCompletionManager::InitializeHostOverlapped – metoda
Poskytuje hostiteli možnost inicializovat všechna vlastní data pro připojení ke struktuře Win32 OVERLAPPED
, která se používá pro asynchronní vstupně-výstupní požadavky.
Syntaxe
HRESULT InitializeHostOverlapped (
[in] void* pvOverlapped
);
Parametry
pvOverlapped
[v] Ukazatel na strukturu Win32 OVERLAPPED
, která se má zahrnout do V/V požadavku.
Návratová hodnota
HRESULT | Description |
---|---|
S_OK | InitializeHostOverlapped úspěšně vráceno. |
HOST_E_CLRNOTAVAILABLE | Modul CLR (Common Language Runtime) nebyl načten do procesu nebo je ve stavu, ve kterém nemůže spustit spravovaný kód nebo úspěšně zpracovat volání. |
HOST_E_TIMEOUT | Časový limit hovoru vypršel. |
HOST_E_NOT_OWNER | Volající zámek nevlastní. |
HOST_E_ABANDONED | Událost byla zrušena, když na ni čekalo blokované vlákno nebo vlákno. |
E_FAIL | Došlo k neznámému katastrofickému selhání. Když metoda vrátí E_FAIL, CLR už není v rámci procesu použitelný. Následná volání metod hostování vrátí HOST_E_CLRNOTAVAILABLE. |
E_OUTOFMEMORY | K přidělení požadovaného prostředku nebyl k dispozici dostatek paměti. |
Poznámky
Funkce platformy Windows používají OVERLAPPED
strukturu k ukládání stavu pro asynchronní vstupně-výstupní požadavky. CLR volá metodu InitializeHostOverlapped
, aby hostiteli dal příležitost připojit vlastní data k OVERLAPPED
instanci.
Důležité
Aby se hostitelé dostali na začátek vlastního datového OVERLAPPED
bloku, musí nastavit posun na velikost struktury (sizeof(OVERLAPPED)
).
Návratová hodnota E_OUTOFMEMORY označuje, že hostiteli se nepodařilo inicializovat vlastní data. V tomto případě CLR hlásí chybu a volání selže.
Požadavky
Platformy: Viz Požadavky na systém.
Záhlaví: MSCorEE.h
Knihovny: Zahrnuto jako prostředek v MSCorEE.dll
Verze rozhraní .NET Framework: K dispozici od verze 2.0