IHostMemoryManager::VirtualQuery — Metoda
Służy jako logiczne otoki dla odpowiedniej funkcji Win32. Implementacja VirtualQuery
win32 pobiera informacje o zakresie stron w wirtualnej przestrzeni adresowej procesu wywoływania.
Składnia
HRESULT VirtualQuery (
[in] void* lpAddress,
[out] void* lpBuffer,
[in] SIZE_T dwLength,
[out] SIZE_T* pResult
);
Parametry
lpAddress
[in] Wskaźnik do adresu w pamięci wirtualnej do odpytowania.
lpBuffer
[out] Wskaźnik do struktury zawierającej informacje o określonym regionie pamięci.
dwLength
[in] Rozmiar w bajtach buforu, który lpBuffer
wskazuje.
pResult
[out] Wskaźnik do liczby bajtów zwracanych przez bufor informacji.
Wartość zwracana
HRESULT | Opis |
---|---|
S_OK | VirtualQuery 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. |
Uwagi
VirtualQuery
Zawiera informacje o zakresie stron w wirtualnej przestrzeni adresowej procesu wywoływania. Ta implementacja ustawia wartość parametru pResult
na liczbę bajtów zwróconych w buforze informacji i zwraca wartość HRESULT. W funkcji Win32 VirtualQuery
zwracana wartość jest rozmiarem buforu. Aby uzyskać więcej informacji, zobacz dokumentację platformy systemu Windows.
Ważne
Implementacja VirtualQuery
systemu operacyjnego nie powoduje zakleszczenia i może zostać uruchomiona do ukończenia z losowymi wątkami zawieszonymi w kodzie użytkownika. Podczas implementowania hostowanej wersji tej metody należy zachować szczególną ostrożność.
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