Metodo ICLRErrorReportingManager::BeginCustomDump

Articolo
08/11/2011

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

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

Parametri

dwFlavor
[in] Valore di ECustomDumpFlavor che indica il tipo di dump dell'heap in base al quale compilare il dump dell'heap personalizzato.
dwNumItems
[in] Lunghezza della matrice items. Se dwFlavor non è DUMP_FLAVOR_Mini, dwNumItems deve essere zero.
items
[in] Matrice di istanze di CustomDumpItem che specificano gli elementi da aggiungere al minidump. Se dwFlavor non è DUMP_FLAVOR_Mini, items deve essere null.
dwReserved
[in] Riservato per un utilizzo futuro.

Valore restituito

HRESULT	Oggetto di descrizione
S_OK	Il metodo ha restituito correttamente un valore.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime non è stato caricato in un processo oppure si trova in uno stato in cui non è possibile eseguire codice gestito né elaborare correttamente la chiamata.
HOST_E_TIMEOUT	Timeout della chiamata.
HOST_E_NOT_OWNER	Il chiamante non è il proprietario del blocco.
HOST_E_ABANDONED	Un evento è stato annullato mentre un thread o un fiber bloccato era in attesa di tale evento.
E_FAIL	Si è verificato un errore irreversibile sconosciuto. Se un metodo restituisce E_FAIL, CLR non sarà più utilizzabile all'interno del processo. Le successive chiamate ai metodi di hosting restituiranno HOST_E_CLRNOTAVAILABLE.

Note

Il metodo BeginCustomDump imposta la configurazione dei dump dell'heap personalizzati. Il metodo EndCustomDump cancella la configurazione dei dump dell'heap personalizzati e rilascia ogni eventuale stato associato. Deve essere chiamato dopo il completamento dei dump dell'heap personalizzati.