AddDumpInformationFileWide

The AddDumpInformationFileWide method registers additional files containing supporting information that will be used when opening a dump file. The ASCII version of this method is AddDumpInformationFile.

HRESULT
  IDebugClient4::AddDumpInformationFileWide(
    IN OPTIONAL PCWSTR  FileName,
    IN ULONG64  FileHandle,
    IN ULONG  Type
    );

Parameters

FileName

Specifies the name of the file containing the supporting information. If FileHandle is not zero, FileName is used only for informational purposes.

FileHandle

Specifies the handle of the file containing the supporting information. If FileHandle is zero, the file named in FileName is used.

Type

Specifies the type of the file in FileName or FileHandle. Currently, only files containing paging file information are supported, and Type must be set to DEBUG_DUMP_FILE_PAGE_FILE_DUMP.

Return Value

S_OK

The method was successful.

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

Interface Version

AddDumpInformationFileWide is available in IDebugClient4 and later versions.

Comments

If supporting information is to be used when opening a dump file, this method or AddDumpInformationFile must be called before OpenDumpFile is called. If a session has already started, this method cannot be used.

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

Requirements

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

See Also

AddDumpInformationFile, GetNumberDumpFiles, GetDumpFile, OpenDumpFile, OpenDumpFileWide