Función WerReportAddDump (werapi.h)

  • Artículo

Agrega un volcado del tipo especificado al informe de Informe de errores de Windows (WER) especificado.

Sintaxis

HRESULT WerReportAddDump(
  [in]           HREPORT                    hReportHandle,
  [in]           HANDLE                     hProcess,
  [in, optional] HANDLE                     hThread,
  [in]           WER_DUMP_TYPE              dumpType,
  [in, optional] PWER_EXCEPTION_INFORMATION pExceptionParam,
  [in, optional] PWER_DUMP_CUSTOM_OPTIONS   pDumpCustomOptions,
  [in]           DWORD                      dwFlags
);

Parámetros

[in] hReportHandle

Identificador del informe. La función WerReportCreate devuelve este identificador.

[in] hProcess

Identificador del proceso para el que se genera el informe. Este identificador debe tener los derechos de acceso STANDARD_RIGHTS_READ y PROCESS_QUERY_INFORMATION.

[in, optional] hThread

Identificador del subproceso de hProcess para el que se genera el informe. Si dumpType es WerDumpTypeMicro, se requiere este parámetro. Para otros tipos de volcado de memoria, este parámetro puede ser NULL.

[in] dumpType

Tipo de minivolcado. Este parámetro puede ser uno de los siguientes valores del tipo de enumeración WER_DUMP_TYPE .

Valor Significado
WerDumpTypeHeapDump
 Minivolcado extendido que contiene datos adicionales, como la memoria del proceso.

Este tipo es equivalente a crear un minivolcado con las siguientes opciones:

  • MiniDumpWithDataSegs
  • MiniDumpWithProcessThreadData
  • MiniDumpWithHandleData
  • MiniDumpWithPrivateReadWriteMemory
  • MiniDumpWithUnloadedModules
  • MiniDumpWithFullMemoryInfo
  • MiniDumpWithThreadInfo (Windows 7 y versiones posteriores)
  • MiniDumpWithTokenInformation (Windows 7 y versiones posteriores)
  • MiniDumpWithPrivateWriteCopyMemory (Windows 7 y versiones posteriores)
WerDumpTypeMicroDump
 Minivolcado limitado que contiene solo un seguimiento de pila.

Este tipo es equivalente a crear un minivolcado con las siguientes opciones:

  • MiniDumpWithDataSegs
  • MiniDumpWithUnloadedModules
  • MiniDumpWithProcessThreadData
  • MiniDumpWithoutOptionalData
WerDumpTypeMiniDump
 Un minivolcado.

Este tipo es equivalente a crear un minivolcado con las siguientes opciones:

  • MiniDumpWithDataSegs
  • MiniDumpWithUnloadedModules
  • MiniDumpWithProcessThreadData
  • MiniDumpWithTokenInformation (Windows 7 y versiones posteriores)

[in, optional] pExceptionParam

Puntero a una estructura WER_EXCEPTION_INFORMATION que especifica información de excepción.

[in, optional] pDumpCustomOptions

Puntero a una estructura de WER_DUMP_CUSTOM_OPTIONS que especifica las opciones de minivolcado personalizadas. Si este parámetro es NULL, se recopila la información de minivolcado estándar.

[in] dwFlags

Este parámetro puede ser 0 o el valor siguiente.

Valor Significado
WER_DUMP_NOHEAP_ONQUEUE
 Si el informe se está en cola, no incluya un volcado de montón. El uso de esta marca ahorra espacio en disco.

Valor devuelto

Esta función devuelve S_OK si se ejecuta correctamente o un código de error en caso de error.

Comentarios

Use esta función solo para informes genéricos; no tiene ningún efecto en los informes de bloqueo del sistema operativo o sin respuesta.

Si el servidor solicita un minivolcado y especifica WerDumpTypeHeapDump para el parámetro dumpType , WER no enviará el volcado de montón al servidor Watson. Sin embargo, si el servidor solicita un volcado de montón y dumpType es WerDumpTypeMiniDump, WER enviará el mini volcado al servidor. Por lo tanto, se recomienda establecer dumpType en WerDumpTypeMiniDump.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado werapi.h
Library Wer.lib
Archivo DLL Wer.dll

Consulte también

Minidump Files, WER_DUMP_CUSTOM_OPTIONS, WER_EXCEPTION_INFORMATION, WerReportCreate, Informe de errores de Windows