struttura WER_DUMP_CUSTOM_OPTIONS (werapi.h)
Specifica le informazioni di minidump Segnalazione errori Windows personalizzate da raccogliere dalla funzione WerReportAddDump.
Sintassi
typedef struct _WER_DUMP_CUSTOM_OPTIONS {
DWORD dwSize;
DWORD dwMask;
DWORD dwDumpFlags;
BOOL bOnlyThisThread;
DWORD dwExceptionThreadFlags;
DWORD dwOtherThreadFlags;
DWORD dwExceptionThreadExFlags;
DWORD dwOtherThreadExFlags;
DWORD dwPreferredModuleFlags;
DWORD dwOtherModuleFlags;
WCHAR wzPreferredModuleList[WER_MAX_PREFERRED_MODULES_BUFFER];
} WER_DUMP_CUSTOM_OPTIONS, *PWER_DUMP_CUSTOM_OPTIONS;
Members
dwSize
Dimensioni della struttura, in byte.
dwMask
Maschera che controlla le opzioni valide in questa struttura. È possibile specificare uno o più dei valori seguenti:
- WER_DUMP_MASK_DUMPTYPE
- WER_DUMP_MASK_ONLY_THISTHREAD
- WER_DUMP_MASK_OTHER_MODULESFLAGS
- WER_DUMP_MASK_OTHERTHREADFLAGS
- WER_DUMP_MASK_OTHERTHREADFLAGS_EX
- WER_DUMP_MASK_PREFERRED_MODULE_LIST
- WER_DUMP_MASK_PREFERRED_MODULESFLAGS
- WER_DUMP_MASK_THREADFLAGS
- WER_DUMP_MASK_THREADFLAGS_EX
dwDumpFlags
Informazioni sul tipo da includere nel minidump. È possibile specificare uno o più flag di MINIDUMP_TYPE .
Questo membro è valido solo se dwMask contiene WER_DUMP_MASK_DUMPTYPE.
bOnlyThisThread
Se questo membro è TRUE e dwMask contiene WER_DUMP_MASK_ONLY_THISTHREAD, il minidump deve essere raccolto solo per il thread chiamante.
dwExceptionThreadFlags
Tipo di informazioni sul thread da includere nel minidump. È possibile specificare uno o più flag di THREAD_WRITE_FLAGS .
Questo membro è valido solo se dwMask contiene WER_DUMP_MASK_THREADFLAGS.
dwOtherThreadFlags
Tipo di informazioni sul thread da includere nel minidump. È possibile specificare uno o più flag di THREAD_WRITE_FLAGS .
Questo membro è valido solo se dwMask contiene WER_DUMP_MASK_OTHERTHREADFLAGS.
dwExceptionThreadExFlags
Tipo di informazioni sul thread da includere nel minidump. È possibile specificare uno o più flag di THREAD_WRITE_FLAGS .
Questo membro è valido solo se dwMask contiene WER_DUMP_MASK_THREADFLAGS_EX.
dwOtherThreadExFlags
Tipo di informazioni sul thread da includere nel minidump. È possibile specificare uno o più flag di THREAD_WRITE_FLAGS .
Questo membro è valido solo se dwMask contiene WER_DUMP_MASK_OTHERTHREADFLAGS_EX.
dwPreferredModuleFlags
Tipo di informazioni sul modulo da includere nel minidump per i moduli specificati nel membro wzPreferredModuleList . È possibile specificare uno o più flag MODULE_WRITE_FLAGS .
Questo membro è valido solo se dwMask contiene WER_DUMP_MASK_PREFERRED_MODULESFLAGS.
dwOtherModuleFlags
Tipo di informazioni sul modulo da includere nel minidump. È possibile specificare uno o più flag MODULE_WRITE_FLAGS .
Questo membro è valido solo se dwMask contiene WER_DUMP_MASK_OTHER_MODULESFLAGS.
wzPreferredModuleList[WER_MAX_PREFERRED_MODULES_BUFFER]
Elenco di nomi di modulo (non includere il percorso) a cui si applicano i flag dwPreferredModuleFlags . Ogni nome deve essere con terminazione Null e l'elenco deve essere terminato con due caratteri Null, ad esempio module1.dll\0module2.dll\0\0.
Per specificare che tutti i moduli sono preferiti, impostare questo membro su *\0\0. Se si include * in un elenco con altri nomi di modulo, l'oggetto * viene ignorato.
Questo membro è valido solo se dwMask contiene WER_DUMP_MASK_PREFERRED_MODULE_LIST.
Commenti
I flag specificati in questa struttura hanno una correlazione diretta ai flag passati nella funzione di callback della funzione di callback MINIDUMP_CALLBACK_ROUTINE (vedere la funzione MiniDumpWriteDump) quando WER genera il file dump.
Se il tipo di input di callback del minidump è ThreadCallback (vedere il membro CallbackType della struttura MINIDUMP_CALLBACK_INPUT), il membro ThreadWriteFlags della struttura MINIDUMP_CALLBACK_OUTPUT viene impostato sui flag specificati nei membri dwExceptionThreadFlags, dwExceptionThreadExFlags, dwOtherThreadFlags o dwOtherThreadExFlags . Se il callback riguarda il thread di arresto anomalo, vengono usati i flag dwExceptionThreadFlags o dwExceptionThreadExFlags ; in caso contrario, vengono usati i flag dwOtherThreadFlags o dwOtherThreadExFlags .
Se il tipo di input di callback è ModuleCallback, il membro ModuleWriteFlags della struttura MINIDUMP_CALLBACK_OUTPUT viene impostato sui flag specificati nei membri dwPreferredModuleFlags o dwOtherModuleFlags . Se il callback è per un modulo nell'elenco dei moduli preferiti, vengono usati i flag dwPreferredModuleFlags ; in caso contrario, vengono usati i flag dwOtherModuleFlags .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Intestazione | werapi.h |