OpenDumpFileWide

The OpenDumpFileWide method opens a dump file as a debugger target.

HRESULT
  IDebugClient4::OpenDumpFileWide(
    IN OPTIONAL PCWSTR  FileName,
    IN ULONG64  FileHandle
    );

Parameters

FileName

Specifies the name of the dump file to open — unless FileHandle is not zero, in which case FileName is used only when the engine is queried for the name of the dump file. 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. FileName can also be in the form of a file URL, starting with "file://". If FileName specifies a cabinet (.cab) file, the cabinet file is searched for the first file with extension .kdmp, then .hdmp, then .mdmp, and finally .dmp.

FileHandle

Specifies the file handle of the dump file to open. If FileHandle is zero, FileName is used to open the dump file. Otherwise, if FileName is not null, the engine returns it when queried for the name of the dump file. If FileHandle is not zero and FileName is NULL, the engine will return <HandleOnly> for the file name.

Return Value

S_OK

The method was successful.

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

Interface Version

OpenDumpFileWide is available in IDebugClient4 and later versions.

Comments

The ASCII version of this method is OpenDumpFile.

Note  The engine doesn't completely attach to the dump file until the WaitForEvent method has been called. When a dump file is created from a process or kernel, information about the last event is stored in the dump file. After the dump file is opened, the next time execution is attempted, the engine will generate this event for the event callbacks. Only then does the dump file become available in the debugging session.

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

Requirements

Headers: Defined in dbgeng.h. Include dbgeng.h.

See Also

OpenDumpFile, .opendump (Open Dump File), AddDumpInformationFile, AddDumpInformationFileWide