estructura WER_DUMP_CUSTOM_OPTIONS (werapi.h)
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 |