IHostMemoryManager::CreateMAlloc-Methode

Artikel
09/02/2008

Aktualisiert: November 2007

Ruft einen Schnittstellenzeiger auf eine IHostMAlloc-Instanz ab, mit der Reservierungsanforderungen von einem Heap durchgeführt werden, der vom Host erstellt wurde.

HRESULT CreateMalloc (
    [in]  DWORD         dwMallocType,
    [out] IHostMalloc **ppMalloc
);

Parameter

dwMallocType
[in] Eine Kombination von MALLOC_TYPE-Flags, die die Eigenschaften des Arbeitsspeichers angibt, der reserviert wird.
ppMAlloc
[out] Ein Zeiger auf die Adresse einer IHostMAlloc-Instanz, die vom Host bereitgestellt wurde.

Rückgabewert

HRESULT	Beschreibung
S_OK	CreateMAlloc kehrte erfolgreich zurück.
HOST_E_CLRNOTAVAILABLE	Die Common Language Runtime (CLR) wurde nicht in einen Prozess geladen oder befindet sich in einem Zustand, in dem sie weder verwalteten Code ausführen noch den Aufruf erfolgreich verarbeiten kann.
HOST_E_TIMEOUT	Der Aufruf hat das Zeitlimit überschritten.
HOST_E_NOT_OWNER	Der Aufrufer ist nicht Besitzer der Sperre.
HOST_E_ABANDONED	Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber auf das Ereignis gewartet hat.
E_FAIL	Ein unbekannter, schwerwiegender Fehler ist aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die CLR innerhalb des Prozesses nicht mehr verwendet werden. Nachfolgende Aufrufe von Hostmethoden geben HOST_E_CLRNOTAVAILABLE zurück.
E_OUTOFMEMORY	Zur Erfüllung der Reservierungsanforderung war nicht genügend physischer Arbeitsspeicher verfügbar.

Hinweise

CreateMAlloc gibt ein Objekt zurück, das der CLR ermöglicht, Reservierungsanforderungen über den Host anstatt mit den normalen Win32-Funktionen vorzunehmen.