Megosztás:


ICLRErrorReportingManager::BeginCustomDump metódus

Megadja az egyéni heap-memóriaképek konfigurációját a hibajelentéshez.

Szintaxis

HRESULT BeginCustomDump (  
    [in] ECustomDumpFlavor dwFlavor,  
    [in] DWORD dwNumItems,  
    [in, size_is(dwNumItems), length_is(dwNumItems)] CustomDumpItem items[],  
    DWORD dwReserved  
);  

Paraméterek

dwFlavor
[in] Egy ECustomDumpFlavor érték, amely azt jelzi, hogy milyen típusú memóriaképet kell létrehoznia az egyéni heap memóriaképnek.

dwNumItems
[in] A tömb hossza items . Ha dwFlavor nem DUMP_FLAVOR_Mini, dwNumItems akkor nullának kell lennie.

items
[in] CustomDumpItem-példányok tömbje, amely megadja a miniképhez hozzáadni kívánt elemeket. Ha dwFlavor nem DUMP_FLAVOR_Mini, items null értékűnek kell lennie.

dwReserved
[in] Jövőbeli használatra fenntartva.

Visszatérési érték

HRESULT Description
S_OK A metódus sikeresen visszaadott.
HOST_E_CLRNOTAVAILABLE A közös nyelvi futtatókörnyezet (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. Miután egy metódus visszaadta E_FAIL, 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.

Megjegyzések

A BeginCustomDump metódus egyéni memóriakép-konfigurációt állít be. Az EndCustomDump metódus törli az egyéni heap memóriakép konfigurációját, és felszabadítja a kapcsolódó állapotokat. Az egyéni memóriakép befejezése után kell meghívni.

Fontos

A hívás EndCustomDump sikertelensége memóriavesztést okoz.

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