estrutura WER_DUMP_CUSTOM_OPTIONS (werapi.h)

  • Artigo

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

Confira também

Função WerReportAddDump, Relatório de Erros do Windows