Método IDebugClient5::WriteDumpFileWide (dbgeng.h)

  • Artículo

El método WriteDumpFileWide crea un archivo de volcado de memoria en modo de usuario o modo kernelcrash.

Sintaxis

HRESULT WriteDumpFileWide(
  [in, optional] PCWSTR  FileName,
  [in]           ULONG64 FileHandle,
  [in]           ULONG   Qualifier,
  [in]           ULONG   FormatFlags,
  [in, optional] PCWSTR  Comment
);

Parámetros

[in, optional] FileName

Especifica el nombre del archivo de volcado de memoria que se va a crear. FileName debe incluir la extensión de nombre de archivo. FileName puede incluir una ruta de acceso relativa o absoluta; las rutas de acceso relativas son relativas al directorio en el que se inició el depurador. Si FileHandle no es NULL, FileName se omite (excepto cuando se escriben mensajes de estado en la consola del depurador).

[in] FileHandle

Especifica el identificador de archivo del archivo en el que se va a escribir el volcado de memoria. Si FileHandle es NULL, se usa en su lugar el archivo especificado en FileName .

[in] Qualifier

Especifica el tipo de volcado de memoria que se va a crear. Para conocer los valores posibles, consulte DEBUG_DUMP_XXX.

[in] FormatFlags

Especifica marcas que determinan el formato del archivo de volcado de memoria y,para minivolcado de usuario, información que se va a incluir en el archivo. Para más información, consulte DEBUG_FORMAT_XXX.

[in, optional] Comment

Especifica una cadena de comentario que se incluirá en el archivo de volcado de memoria. Esta cadena se muestra en la consola del depurador cuando se carga el archivo de volcado.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto Descripción
S_OK
 Método realizado correctamente.

Comentarios

Para obtener más información sobre los archivos de volcado de memoria, vea Destinos de archivo de volcado de memoria.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado dbgeng.h (include Dbgeng.h)

Consulte también

.dump (Crear archivo de volcado)

IDebugClient4

IDebugClient5

WriteDumpFile2