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

Vedi anche

Funzione WerReportAddDump, Segnalazione errori Windows