IHostMAlloc::DebugAlloc — Metoda
Żąda, aby host przydzielił określoną ilość pamięci ze stert i dodatkowo śledzi miejsce przydzielenia pamięci.
Składnia
HRESULT DebugAlloc (
[in] SIZE_T cbSize,
[in] EMemoryCriticalLevel dwCriticalLevel,
[in] char* pszFileName,
[in] int iLineNo,
[out] void** ppMem
);
Parametry
cbSize
[in] Rozmiar w bajtach bieżącego żądania alokacji pamięci.
dwCriticalLevel
[in] Jedna z wartości EMemoryCriticalLevel wskazująca wpływ błędu alokacji.
pszFileName
[in] Plik kodu pliku wykonywalnego debugowanego.
iLineNo
[in] Numer wiersza, w pszFileName którym zażądano alokacji.
ppMem
[out] Wskaźnik do przydzielonej pamięci lub wartość null, jeśli nie można ukończyć żądania.
Wartość zwracana
| HRESULT | Opis |
|---|---|
| S_OK | DebugAlloc zwrócone pomyślnie. |
| HOST_E_CLRNOTAVAILABLE | ClR nie został załadowany do procesu lub CLR jest w stanie, w którym nie może uruchomić zarządzanego kodu lub przetworzyć wywołania pomyślnie. |
| 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 ukończyć żądanie alokacji. |
Uwagi
ClR pobiera wskaźnik interfejsu do wystąpienia IHostMalloc przez wywołanie metody IHostMemoryManager::CreateMalloc . DebugAlloc umożliwia środowisku uruchomieniowemu pobieranie informacji o pliku kodu do użycia podczas debugowania.
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
