IDebugClient4::AddDumpInformationFileWide-Methode (dbgeng.h)

Artikel
02/06/2025

Die methode AddDumpInformationFileWide registriert zusätzliche Dateien, die unterstützende Informationen enthalten, die beim Öffnen einer Dumpdateiverwendet werden. Die ASCII-Version dieser Methode ist AddDumpInformationFile.

Syntax

HRESULT AddDumpInformationFileWide(
  [in, optional] PCWSTR  FileName,
  [in]           ULONG64 FileHandle,
  [in]           ULONG   Type
);

Parameter

[in, optional] FileName

Gibt den Namen der Datei an, die die unterstützenden Informationen enthält. Wenn FileHandle- nicht null ist, wird FileName- nur zu Informationszwecken verwendet.

[in] FileHandle

Gibt das Handle der Datei an, die die unterstützenden Informationen enthält. Wenn FileHandle- null ist, wird die in FileName- benannte Datei verwendet.

[in] Type

Gibt den Typ der Datei in FileName- oder FileHandle-an. Derzeit werden nur Dateien mit Auslagerungsdateiinformationen unterstützt, und Typ- müssen auf DEBUG_DUMP_FILE_PAGE_FILE_DUMP festgelegt werden.

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.

Bemerkungen

Wenn unterstützende Informationen beim Öffnen einer Speicherabbilddatei verwendet werden sollen, muss diese Methode oder AddDumpInformationFile- aufgerufen werden, bevor OpenDumpFile- aufgerufen wird. Wenn eine Sitzung bereits gestartet wurde, kann diese Methode nicht verwendet werden.

Weitere Informationen zu Absturzabbilddateien finden Sie unter Dump-File Targets.