IHostIoCompletionManager::InitializeHostOverlapped — Metoda
Zapewnia hostowi możliwość zainicjowania dowolnych danych niestandardowych w celu dołączenia ich do struktury Win32 OVERLAPPED używanej na potrzeby asynchronicznych żądań we/wy.
Składnia
HRESULT InitializeHostOverlapped (
[in] void* pvOverlapped
);
Parametry
pvOverlapped
[in] Wskaźnik do struktury Win32 OVERLAPPED , który ma zostać dołączony do żądania We/Wy.
Wartość zwracana
| HRESULT | Opis |
|---|---|
| S_OK | InitializeHostOverlapped zwrócone pomyślnie. |
| HOST_E_CLRNOTAVAILABLE | Środowisko uruchomieniowe języka wspólnego (CLR) nie zostało załadowane do procesu lub clR jest w stanie, w którym nie może uruchomić kodu zarządzanego ani pomyślnie przetworzyć wywołania. |
| HOST_E_TIMEOUT | Upłynął limit czasu wywołania. |
| HOST_E_NOT_OWNER | Obiekt wywołujący nie jest właścicielem blokady. |
| HOST_E_ABANDONED | Zdarzenie zostało anulowane, gdy zablokowany wątek lub światłowod czekał na nie. |
| E_FAIL | Wystąpił nieznany katastrofalny błąd. Gdy metoda zwraca E_FAIL, clR nie będzie już można jej używać w ramach tego procesu. Kolejne wywołania metod hostingu zwracają HOST_E_CLRNOTAVAILABLE. |
| E_OUTOFMEMORY | Za mało pamięci, aby przydzielić żądany zasób. |
Uwagi
Funkcje platformy Windows używają OVERLAPPED struktury do przechowywania stanu dla asynchronicznych żądań we/wy. ClR wywołuje metodę InitializeHostOverlapped , aby dać hostowi możliwość dołączania danych niestandardowych do OVERLAPPED wystąpienia.
Ważne
Aby przejść do początku niestandardowego bloku danych, hosty muszą ustawić przesunięcie na rozmiar OVERLAPPED struktury (sizeof(OVERLAPPED)).
Wartość zwracana E_OUTOFMEMORY wskazuje, że host nie może zainicjować swoich danych niestandardowych. W takim przypadku clR zgłasza błąd i kończy się niepowodzeniem wywołania.
Wymagania
Platformy: Zobacz Wymagania systemowe.
Nagłówka: MSCorEE.h
Biblioteki: Uwzględnione jako zasób w MSCorEE.dll
wersje .NET Framework: dostępne od wersji 2.0
