Delen via

Methode IHostMAlloc::D ebugAlloc

  • Artikel

Vraagt de host om de opgegeven hoeveelheid geheugen van de heap toe te wijzen en daarnaast bij te houden waar het geheugen is toegewezen.

Syntaxis

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

Parameters

cbSize
[in] De grootte, in bytes, van de huidige aanvraag voor geheugentoewijzing.

dwCriticalLevel
[in] Een van de EMemoryCriticalLevel-waarden , die de impact van een toewijzingsfout aangeeft.

pszFileName
[in] Het codebestand van het uitvoerbare bestand dat wordt opgespoord.

iLineNo
[in] Het regelnummer waarin pszFileName de toewijzing is aangevraagd.

ppMem
[uit] Een aanwijzer naar het toegewezen geheugen of null als de aanvraag niet kan worden voltooid.

Retourwaarde

HRESULT Beschrijving
S_OK DebugAlloc is geretourneerd.
HOST_E_CLRNOTAVAILABLE De CLR is niet geladen in een proces of de CLR heeft een status waarin beheerde code niet kan worden uitgevoerd of de aanroep kan worden verwerkt.
HOST_E_TIMEOUT Er is een time-out opgetreden voor het gesprek.
HOST_E_NOT_OWNER De beller is niet de eigenaar van het slot.
HOST_E_ABANDONED Een gebeurtenis is geannuleerd terwijl er een geblokkeerde thread of glasvezel op wachtte.
E_FAIL Er is een onbekende catastrofale fout opgetreden. Wanneer een methode E_FAIL retourneert, is de CLR niet meer bruikbaar binnen het proces. Volgende aanroepen naar hostingmethoden retourneren HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY Er was onvoldoende geheugen beschikbaar om de toewijzingsaanvraag te voltooien.

Opmerkingen

De CLR haalt een interfaceaanwijzer op naar een IHostMalloc-exemplaar door de methode IHostMemoryManager::CreateMalloc aan te roepen. DebugAlloc stelt de runtime in staat om codebestandsgegevens op te halen voor gebruik tijdens foutopsporing.

Vereisten

Platforms: Zie Systeemvereisten.

Header: MSCorEE.h

Bibliotheek: Opgenomen als een resource in MSCorEE.dll

.NET Framework versies: beschikbaar sinds 2.0

Zie ook