Compartir a través de


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

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

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 al escribir mensajes de estado en la consola del depurador).

[in] FileHandle

Especifica el identificador de 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 y,para minidumps en modo de usuario, información que se va a incluir en el archivo. Para obtener 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 información.

Código devuelto Descripción
S_OK
El método se realizó correctamente.

Observaciones

Para obtener más información sobre los archivos de volcado de memoria, consulte Dump-File Targets.

Requisitos

Requisito Valor
de la plataforma de destino de Escritorio
encabezado de dbgeng.h (include Dbgeng.h)

Consulte también

.dump (Crear archivo de volcado de memoria)

IDebugClient4

IDebugClient5

WriteDumpFile2