Udostępnij za pośrednictwem

IHostMAlloc::Alloc — Metoda

  • Artykuł

Żąda, aby host przydzielił określoną ilość pamięci ze stert.

Składnia

HRESULT Alloc (  
    [in] SIZE_T  cbSize,
    [in] EMemoryCriticalLevel dwCriticalLevel,
    [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.

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 Alloc 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 ukończyć żądanie alokacji.

Uwagi

ClR pobiera wskaźnik interfejsu do IHostMalloc wystąpienia, wywołując metodę IHostMemoryManager::CreateMalloc .

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

Zobacz też