IHostMAlloc::DebugAlloc-Methode

Aktualisiert: November 2007

Fordert an, dass der Host die angegebene Größe des Speichers aus dem Heap reserviert und außerdem nachverfolgt, wo der Speicher reserviert wurde.

HRESULT DebugAlloc (
    [in]  SIZE_T  cbSize, 
    [in]  EMemoryCriticalLevel dwCriticalLevel, 
    [in]  char*   pszFileName, 
    [in]  int     iLineNo, 
    [out] void**  ppMem
);

Parameter

cbSize
[in] Die Größe der aktuellen Speicherreservierungsanforderung in Bytes.
dwCriticalLevel
[in] Einer der EMemoryCriticalLevel-Werte, der die Auswirkungen eines Reservierungsfehlers angibt.
pszFileName
[in] Die Codedatei der ausführbaren Datei, die gedebuggt wird.
iLineNo
[in] Die Zeilennummer in pszFileName, in der die Reservierung angefordert wurde.
ppMem
[out] Ein Zeiger auf den reservierten Arbeitsspeicher oder NULL, wenn die Anforderung nicht abgeschlossen werden konnte.

Rückgabewert

HRESULT	Beschreibung
S_OK	DebugAlloc kehrte erfolgreich zurück.
HOST_E_CLRNOTAVAILABLE	Die 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 Arbeitsspeicher verfügbar.

Hinweise

Die CLR erhält einen Schnittstellenzeiger auf eine IHostMAlloc-Instanz, indem die IHostMemoryManager::CreateMAlloc-Methode aufgerufen wird. DebugAlloc ermöglicht es der Common Language Runtime, Codedateiinformationen zur Verwendung beim Debuggen abzurufen.