estructura WER_DUMP_CUSTOM_OPTIONS (werapi.h)

  • Artículo

Especifica la información de minivolcado de Informe de errores de Windows personalizada (WER) que recopilará la función WerReportAddDump.

Sintaxis

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;

Miembros

dwSize

El tamaño de la estructura en bytes.

dwMask

Máscara que controla qué opciones son válidas en esta estructura. Puede especificar uno o varios de los valores siguientes:

  • 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

Información de tipo que se va a incluir en el minivolcado. Puede especificar una o varias de las marcas de MINIDUMP_TYPE .

Este miembro solo es válido si dwMask contiene WER_DUMP_MASK_DUMPTYPE.

bOnlyThisThread

Si este miembro es TRUE y dwMask contiene WER_DUMP_MASK_ONLY_THISTHREAD, el minivolcado se recopilará solo para el subproceso que realiza la llamada.

dwExceptionThreadFlags

Tipo de información de subproceso que se va a incluir en el minivolcado. Puede especificar una o varias de las marcas de THREAD_WRITE_FLAGS .

Este miembro solo es válido si dwMask contiene WER_DUMP_MASK_THREADFLAGS.

dwOtherThreadFlags

Tipo de información de subproceso que se va a incluir en el minivolcado. Puede especificar una o varias de las marcas de THREAD_WRITE_FLAGS .

Este miembro solo es válido si dwMask contiene WER_DUMP_MASK_OTHERTHREADFLAGS.

dwExceptionThreadExFlags

Tipo de información de subproceso que se va a incluir en el minivolcado. Puede especificar una o varias de las marcas de THREAD_WRITE_FLAGS .

Este miembro solo es válido si dwMask contiene WER_DUMP_MASK_THREADFLAGS_EX.

dwOtherThreadExFlags

Tipo de información de subproceso que se va a incluir en el minivolcado. Puede especificar una o varias de las marcas de THREAD_WRITE_FLAGS .

Este miembro solo es válido si dwMask contiene WER_DUMP_MASK_OTHERTHREADFLAGS_EX.

dwPreferredModuleFlags

Tipo de información del módulo que se va a incluir en el minivolcado de los módulos especificados en el miembro wzPreferredModuleList . Puede especificar una o varias de las marcas de MODULE_WRITE_FLAGS .

Este miembro solo es válido si dwMask contiene WER_DUMP_MASK_PREFERRED_MODULESFLAGS.

dwOtherModuleFlags

Tipo de información del módulo que se va a incluir en el minivolcado. Puede especificar una o varias de las marcas de MODULE_WRITE_FLAGS .

Este miembro solo es válido si dwMask contiene WER_DUMP_MASK_OTHER_MODULESFLAGS.

wzPreferredModuleList[WER_MAX_PREFERRED_MODULES_BUFFER]

Una lista de nombres de módulo (no incluya la ruta de acceso) a la que se aplican las marcas dwPreferredModuleFlags . Cada nombre debe terminar en null y la lista debe terminar con dos caracteres NULL (por ejemplo, module1.dll\0module2.dll\0\0).

Para especificar que se prefieren todos los módulos, establezca este miembro en *\0\0. Si incluye * en una lista con otros nombres de módulo, * se omite .

Este miembro solo es válido si dwMask contiene WER_DUMP_MASK_PREFERRED_MODULE_LIST.

Comentarios

Las marcas especificadas en esta estructura tienen una correlación directa con las marcas pasadas en la función de devolución de llamada MINIDUMP_CALLBACK_ROUTINE función de devolución de llamada (consulte la función MiniDumpWriteDump) cuando WER genera el archivo de volcado.

Si el tipo de entrada de devolución de llamada de la minivolcado es ThreadCallback (vea el miembro CallbackType de MINIDUMP_CALLBACK_INPUT estructura), el miembro ThreadWriteFlags de MINIDUMP_CALLBACK_OUTPUT estructura se establece en las marcas especificadas en los miembros dwExceptionThreadFlags, dwExceptionThreadExFlags, dwOtherThreadFlags o dwOtherThreadExFlags . Si la devolución de llamada es para el subproceso que se bloquea, se usan las marcas dwExceptionThreadFlags o dwExceptionThreadExFlags ; De lo contrario, se usan las marcas dwOtherThreadFlags o dwOtherThreadExFlags .

Si el tipo de entrada de devolución de llamada es ModuleCallback, el miembro ModuleWriteFlags de MINIDUMP_CALLBACK_OUTPUT estructura se establece en las marcas especificadas en los miembros dwPreferredModuleFlags o dwOtherModuleFlags . Si la devolución de llamada es para un módulo de la lista de módulos preferidos, se usan las marcas dwPreferredModuleFlags ; De lo contrario, se usan las marcas dwOtherModuleFlags .

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado werapi.h

Consulte también

Función WerReportAddDump, Informe de errores de Windows