estrutura WER_DUMP_CUSTOM_OPTIONS (werapi.h)
Especifica informações de minidump de Relatório de Erros do Windows personalizadas (WER) a serem coletadas pela função WerReportAddDump.
Sintaxe
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;
Membros
dwSize
O tamanho da estrutura em bytes.
dwMask
Uma máscara que controla quais opções são válidas nessa estrutura. Você pode especificar um ou mais dos seguintes valores:
- 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
As informações de tipo a serem incluídas no minidump. Você pode especificar um ou mais dos sinalizadores de MINIDUMP_TYPE .
Esse membro só será válido se dwMask contiver WER_DUMP_MASK_DUMPTYPE.
bOnlyThisThread
Se esse membro for TRUE e dwMask contiver WER_DUMP_MASK_ONLY_THISTHREAD, o minidump será coletado somente para o thread de chamada.
dwExceptionThreadFlags
O tipo de informações de thread a serem incluídas no minidump. Você pode especificar um ou mais dos sinalizadores de THREAD_WRITE_FLAGS .
Esse membro só será válido se dwMask contiver WER_DUMP_MASK_THREADFLAGS.
dwOtherThreadFlags
O tipo de informações de thread a serem incluídas no minidump. Você pode especificar um ou mais dos sinalizadores de THREAD_WRITE_FLAGS .
Esse membro só será válido se dwMask contiver WER_DUMP_MASK_OTHERTHREADFLAGS.
dwExceptionThreadExFlags
O tipo de informações de thread a serem incluídas no minidump. Você pode especificar um ou mais dos sinalizadores de THREAD_WRITE_FLAGS .
Esse membro só será válido se dwMask contiver WER_DUMP_MASK_THREADFLAGS_EX.
dwOtherThreadExFlags
O tipo de informações de thread a serem incluídas no minidump. Você pode especificar um ou mais dos sinalizadores de THREAD_WRITE_FLAGS .
Esse membro só será válido se dwMask contiver WER_DUMP_MASK_OTHERTHREADFLAGS_EX.
dwPreferredModuleFlags
O tipo de informações de módulo a serem incluídas no minidump para módulos especificados no membro wzPreferredModuleList . Você pode especificar um ou mais dos sinalizadores de MODULE_WRITE_FLAGS .
Esse membro só será válido se dwMask contiver WER_DUMP_MASK_PREFERRED_MODULESFLAGS.
dwOtherModuleFlags
O tipo de informações de módulo a serem incluídas no minidump. Você pode especificar um ou mais dos sinalizadores de MODULE_WRITE_FLAGS .
Esse membro só será válido se dwMask contiver WER_DUMP_MASK_OTHER_MODULESFLAGS.
wzPreferredModuleList[WER_MAX_PREFERRED_MODULES_BUFFER]
Uma lista de nomes de módulo (não incluem o caminho) ao qual os sinalizadores dwPreferredModuleFlags se aplicam. Cada nome deve ser encerrado em nulo e a lista deve ser encerrada com dois caracteres nulos (por exemplo, module1.dll\0module2.dll\0\0).
Para especificar que todos os módulos são preferenciais, defina esse membro como *\0\0. Se você incluir * em uma lista com outros nomes de módulo, o * será ignorado.
Esse membro só será válido se dwMask contiver WER_DUMP_MASK_PREFERRED_MODULE_LIST.
Comentários
Os sinalizadores especificados nessa estrutura têm uma correlação direta com sinalizadores passados na função de retorno de chamada MINIDUMP_CALLBACK_ROUTINE função de retorno de chamada (consulte Função MiniDumpWriteDump) quando o WER gera o arquivo de despejo.
Se o tipo de entrada de retorno de chamada do minidump for ThreadCallback (consulte o membro CallbackType de MINIDUMP_CALLBACK_INPUT estrutura), o membro ThreadWriteFlags de MINIDUMP_CALLBACK_OUTPUT estrutura será definido como os sinalizadores especificados nos membros dwExceptionThreadFlags, dwExceptionThreadExFlags, dwOtherThreadFlags ou dwOtherThreadExFlags . Se o retorno de chamada for para o thread de falha, os sinalizadores dwExceptionThreadFlags ou dwExceptionThreadExFlags serão usados ; caso contrário, os sinalizadores dwOtherThreadFlags ou dwOtherThreadExFlags são usados .
Se o tipo de entrada de retorno de chamada for ModuleCallback, o membro ModuleWriteFlags de MINIDUMP_CALLBACK_OUTPUT estrutura será definido como os sinalizadores especificados nos membros dwPreferredModuleFlags ou dwOtherModuleFlags . Se o retorno de chamada for para um módulo na lista de módulos preferenciais, os sinalizadores dwPreferredModuleFlags serão usados ; caso contrário, os sinalizadores dwOtherModuleFlags são usados .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Cabeçalho | werapi.h |