IDebugClient5::WriteDumpFileWide method

The WriteDumpFileWide method creates a user-mode or kernel-modecrash dump file.

Syntax

HRESULT WriteDumpFileWide(
  PCWSTR  FileName,
  ULONG64 FileHandle,
  ULONG   Qualifier,
  ULONG   FormatFlags,
  PCWSTR  Comment
);

Parameters

FileName

Specifies the name of the dump file to create. FileName must include the file name extension. FileName can include a relative or absolute path; relative paths are relative to the directory in which the debugger was started. If FileHandle is not NULL, FileName is ignored (except when writing status messages to the debugger console).

FileHandle

Specifies the file handle of the file to write the crash dump to. If FileHandle is NULL, the file specified in FileName is used instead.

Qualifier

Specifies the type of dump to create. For possible values, see DEBUG_DUMP_XXX.

FormatFlags

Specifies flags that determine the format of the dump file and--for user-mode minidumps--what information to include in the file. For details, see DEBUG_FORMAT_XXX.

Comment

Specifies a comment string to be included in the crash dump file. This string is displayed in the debugger console when the dump file is loaded.

Return Value

This method may also return error values. See Return Values for more details.

Return code Description
S_OK
The method was successful.

Remarks

For more information about crash dump files, see Dump-File Targets.

Requirements

   
Target Platform Desktop
Header dbgeng.h (include Dbgeng.h)

See Also

.dump (Create Dump File)

IDebugClient4

IDebugClient5

WriteDumpFile2