IHostMAlloc::D ebugAlloc metódus

Azt kéri, hogy a gazdagép lefoglalja a megadott mennyiségű memóriát a heapból, és nyomon kövesse a memória lefoglalásának helyét.

Szintaxis

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

Paraméterek

cbSize
[in] Az aktuális memóriafoglalási kérelem mérete bájtban.

dwCriticalLevel
[in] Az egyik EMemoryCriticalLevel érték, amely egy foglalási hiba hatását jelzi.

pszFileName
[in] A hibakeresés alatt álló végrehajtható fájl kódfájlja.

iLineNo
[in] Az a sorszám, amelyben pszFileName a foglalást kérték.

ppMem
[kifelé] Mutató a lefoglalt memóriára, vagy null értékű, ha a kérés nem hajtható végre.

Visszatérési érték

HRESULT	Description
S_OK	DebugAlloc sikeresen visszaadott.
HOST_E_CLRNOTAVAILABLE	A CLR nincs betöltve egy folyamatba, vagy a CLR olyan állapotban van, amelyben nem tudja futtatni a felügyelt kódot, vagy nem tudja sikeresen feldolgozni a hívást.
HOST_E_TIMEOUT	A hívás túllépte az időkorlátot.
HOST_E_NOT_OWNER	A hívó nem rendelkezik a zárral.
HOST_E_ABANDONED	Egy esemény megszakadt, miközben egy blokkolt szál vagy szál várakozott rá.
E_FAIL	Ismeretlen katasztrofális hiba történt. Amikor egy metódus E_FAIL ad vissza, a CLR már nem használható a folyamaton belül. Az üzemeltetési módszerekre irányuló későbbi hívások HOST_E_CLRNOTAVAILABLE adnak vissza.
E_OUTOFMEMORY	Nem volt elég memória a foglalási kérelem befejezéséhez.

Megjegyzések

A CLR az IHostMemoryManager::CreateMalloc metódus meghívásával egy IHostMalloc-példányra mutató illesztőmutatót kap. DebugAlloc lehetővé teszi, hogy a futtatókörnyezet lekérje a kódfájl adatait a hibakeresés során.

Követelmények

Platformok: Lásd: Rendszerkövetelmények.

Fejléc: MSCorEE.h

Könyvtár: Erőforrásként szerepel a MSCorEE.dll

.NET-keretrendszer verziók: 2.0 óta érhető el

Lásd még

• IHostMemoryManager felület
• IHostMalloc felület