Metodo ICLRErrorReportingManager::BeginCustomDump

Articolo
05/10/2023

Specifica la configurazione dei dump dell'heap personalizzati per la segnalazione degli errori.

Sintassi

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

Parametri

dwFlavor
[in] Valore ECustomDumpFlavor che indica il tipo di dump dell'heap su cui compilare il dump dell'heap personalizzato.

dwNumItems
[in] Lunghezza della items matrice. Se dwFlavor non è DUMP_FLAVOR_Mini, dwNumItems deve essere zero.

items
[in] Matrice di istanze CustomDumpItem , che specifica gli elementi da aggiungere al mini-dump. Se dwFlavor non è DUMP_FLAVOR_Mini, items deve essere Null.

dwReserved
[in] Riservato per un utilizzo futuro.

Valore restituito

HRESULT	Descrizione
S_OK	Il metodo è stato restituito correttamente.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime (CLR) non è stato caricato in un processo oppure CLR si trova in uno stato in cui non è possibile eseguire codice gestito o elaborare correttamente la chiamata.
HOST_E_TIMEOUT	Timeout della chiamata.
HOST_E_NOT_OWNER	Il chiamante non possiede il blocco.
HOST_E_ABANDONED	Un evento è stato annullato durante l'attesa di un thread o di una fibra bloccata.
E_FAIL	Si è verificato un errore irreversibile sconosciuto. Dopo che un metodo restituisce E_FAIL, CLR non è più utilizzabile all'interno del processo. Le chiamate successive ai metodi di hosting restituiscono HOST_E_CLRNOTAVAILABLE.

Commenti

Il BeginCustomDump metodo imposta la configurazione del dump dell'heap personalizzata. Il metodo EndCustomDump cancella la configurazione del dump dell'heap personalizzato e libera qualsiasi stato associato. Deve essere chiamato dopo il completamento del dump dell'heap personalizzato.

Importante

La mancata chiamata EndCustomDump causa la perdita di memoria.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MSCorEE.h

Libreria: Incluso come risorsa in MSCorEE.dll

Versioni di .NET Framework: Disponibile dalla versione 2.0

Condividi tramite