Partager via

WER_DUMP_CUSTOM_OPTIONS structure (werapi.h)

  • Article

Spécifie les informations minidump de Rapport d'erreurs Windows personnalisées (WER) à collecter par la fonction WerReportAddDump.

Syntaxe

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;

Membres

dwSize

Taille de la structure, en octets.

dwMask

Masque qui contrôle les options valides dans cette structure. Vous pouvez spécifier une ou plusieurs des valeurs suivantes :

  • 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

Informations de type à inclure dans le minidump. Vous pouvez spécifier un ou plusieurs indicateurs de MINIDUMP_TYPE .

Ce membre est valide uniquement si dwMask contient WER_DUMP_MASK_DUMPTYPE.

bOnlyThisThread

Si ce membre a la valeur TRUE et que dwMask contient WER_DUMP_MASK_ONLY_THISTHREAD, le minidump doit être collecté uniquement pour le thread appelant.

dwExceptionThreadFlags

Type d’informations de thread à inclure dans le minidump. Vous pouvez spécifier un ou plusieurs indicateurs de THREAD_WRITE_FLAGS .

Ce membre est valide uniquement si dwMask contient WER_DUMP_MASK_THREADFLAGS.

dwOtherThreadFlags

Type d’informations de thread à inclure dans le minidump. Vous pouvez spécifier un ou plusieurs indicateurs de THREAD_WRITE_FLAGS .

Ce membre est valide uniquement si dwMask contient WER_DUMP_MASK_OTHERTHREADFLAGS.

dwExceptionThreadExFlags

Type d’informations de thread à inclure dans le minidump. Vous pouvez spécifier un ou plusieurs indicateurs de THREAD_WRITE_FLAGS .

Ce membre est valide uniquement si dwMask contient WER_DUMP_MASK_THREADFLAGS_EX.

dwOtherThreadExFlags

Type d’informations de thread à inclure dans le minidump. Vous pouvez spécifier un ou plusieurs indicateurs de THREAD_WRITE_FLAGS .

Ce membre est valide uniquement si dwMask contient WER_DUMP_MASK_OTHERTHREADFLAGS_EX.

dwPreferredModuleFlags

Type d’informations de module à inclure dans le minidump pour les modules spécifiés dans le membre wzPreferredModuleList . Vous pouvez spécifier un ou plusieurs indicateurs de MODULE_WRITE_FLAGS .

Ce membre est valide uniquement si dwMask contient WER_DUMP_MASK_PREFERRED_MODULESFLAGS.

dwOtherModuleFlags

Type d’informations de module à inclure dans le minidump. Vous pouvez spécifier un ou plusieurs indicateurs de MODULE_WRITE_FLAGS .

Ce membre est valide uniquement si dwMask contient WER_DUMP_MASK_OTHER_MODULESFLAGS.

wzPreferredModuleList[WER_MAX_PREFERRED_MODULES_BUFFER]

Liste des noms de module (ne pas inclure le chemin) auxquels les indicateurs dwPreferredModuleFlags s’appliquent . Chaque nom doit être terminé par null, et la liste doit être terminée avec deux caractères Null (par exemple, module1.dll\0module2.dll\0\0).

Pour spécifier que tous les modules sont préférés, définissez ce membre sur *\0\0. Si vous incluez * dans une liste avec d’autres noms de module, est * ignoré.

Ce membre est valide uniquement si dwMask contient WER_DUMP_MASK_PREFERRED_MODULE_LIST.

Remarques

Les indicateurs spécifiés dans cette structure ont une corrélation directe avec les indicateurs passés dans la fonction de rappel MINIDUMP_CALLBACK_ROUTINE fonction de rappel de la fonction de rappel (voir Fonction MiniDumpWriteDump) lorsque WER génère le fichier de vidage.

Si le type d’entrée de rappel du minidump est ThreadCallback (voir le membre CallbackType de MINIDUMP_CALLBACK_INPUT structure), le membre ThreadWriteFlags de MINIDUMP_CALLBACK_OUTPUT structure est défini sur les indicateurs spécifiés dans les membres dwExceptionThreadFlags, dwExceptionThreadExFlags, dwOtherThreadFlags ou dwOtherThreadExFlags . Si le rappel est destiné au thread en panne, les indicateurs dwExceptionThreadFlags ou dwExceptionThreadExFlags sont utilisés ; sinon, les indicateurs dwOtherThreadFlags ou dwOtherThreadExFlags sont utilisés.

Si le type d’entrée de rappel est ModuleCallback, le membre ModuleWriteFlags de MINIDUMP_CALLBACK_OUTPUT structure est défini sur les indicateurs spécifiés dans les membres dwPreferredModuleFlags ou dwOtherModuleFlags . Si le rappel concerne un module de la liste des modules préférés, les indicateurs dwPreferredModuleFlags sont utilisés ; sinon, les indicateurs dwOtherModuleFlags sont utilisés.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
En-tête werapi.h

Voir aussi

Fonction WerReportAddDump, Rapport d'erreurs Windows