Sdílet prostřednictvím


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

Viz také