Share via

Funzione WerReportAddDump (werapi.h)

  • Articolo

Aggiunge un dump del tipo specificato al report Segnalazione errori Windows (WER) specificato.

Sintassi

HRESULT WerReportAddDump(
  [in]           HREPORT                    hReportHandle,
  [in]           HANDLE                     hProcess,
  [in, optional] HANDLE                     hThread,
  [in]           WER_DUMP_TYPE              dumpType,
  [in, optional] PWER_EXCEPTION_INFORMATION pExceptionParam,
  [in, optional] PWER_DUMP_CUSTOM_OPTIONS   pDumpCustomOptions,
  [in]           DWORD                      dwFlags
);

Parametri

[in] hReportHandle

Handle per il report. Questo handle viene restituito dalla funzione WerReportCreate .

[in] hProcess

Handle per il processo per il quale viene generato il report. Questo handle deve avere i diritti di accesso STANDARD_RIGHTS_READ e PROCESS_QUERY_INFORMATION.

[in, optional] hThread

Handle per il thread di hProcess per cui viene generato il report. Se dumpType è WerDumpTypeMicro, questo parametro è obbligatorio. Per altri tipi di dump, questo parametro può essere NULL.

[in] dumpType

Tipo di minidump. Questo parametro può essere uno dei valori seguenti dal tipo di enumerazione WER_DUMP_TYPE .

Valore Significato
WerDumpTypeHeapDump
 Minidump esteso che contiene dati aggiuntivi, ad esempio la memoria del processo.

Questo tipo equivale alla creazione di un minidump con le opzioni seguenti:

  • MiniDumpWithDataSegs
  • MiniDumpWithProcessThreadData
  • MiniDumpWithHandleData
  • MiniDumpWithPrivateReadWriteMemory
  • MiniDumpWithUnloadedModules
  • MiniDumpWithFullMemoryInfo
  • MiniDumpWithThreadInfo (Windows 7 e versioni successive)
  • MiniDumpWithTokenInformation (Windows 7 e versioni successive)
  • MiniDumpWithPrivateWriteCopyMemory (Windows 7 e versioni successive)
WerDumpTypeMicroDump
 Minidump limitato che contiene solo un'analisi dello stack.

Questo tipo equivale alla creazione di un minidump con le opzioni seguenti:

  • MiniDumpWithDataSegs
  • MiniDumpWithUnloadedModules
  • MiniDumpWithProcessThreadData
  • MiniDumpWithoutOptionalData
WerDumpTypeMiniDump
 Un minidump.

Questo tipo equivale alla creazione di un minidump con le opzioni seguenti:

  • MiniDumpWithDataSegs
  • MiniDumpWithUnloadedModules
  • MiniDumpWithProcessThreadData
  • MiniDumpWithTokenInformation (Windows 7 e versioni successive)

[in, optional] pExceptionParam

Puntatore a una struttura WER_EXCEPTION_INFORMATION che specifica le informazioni sulle eccezioni.

[in, optional] pDumpCustomOptions

Puntatore a una struttura WER_DUMP_CUSTOM_OPTIONS che specifica le opzioni di minidump personalizzate. Se questo parametro è NULL, vengono raccolte le informazioni di minidump standard.

[in] dwFlags

Questo parametro può essere 0 o il valore seguente.

Valore Significato
WER_DUMP_NOHEAP_ONQUEUE
 Se il report è in coda, non includere un dump dell'heap. L'uso di questo flag consente di risparmiare spazio su disco.

Valore restituito

Questa funzione restituisce S_OK in caso di esito positivo o di codice di errore in caso di errore.

Commenti

Usare questa funzione solo per la creazione di report generici: non ha alcun effetto sull'arresto anomalo del sistema operativo o sulla segnalazione di nessuna risposta.

Se il server richiede un mini dump e si specifica WerDumpTypeHeapDump per il parametro dumpType , WER non invierà il dump dell'heap al server Watson. Tuttavia, se il server richiede un dump dell'heap e dumpType è WerDumpTypeMiniDump, WER invierà il mini dump al server. È quindi consigliabile impostare dumpType su WerDumpTypeMiniDump.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione werapi.h
Libreria Wer.lib
DLL Wer.dll

Vedi anche

Minidump Files, WER_DUMP_CUSTOM_OPTIONS, WER_EXCEPTION_INFORMATION, WerReportCreate, Segnalazione errori Windows