IDebugClient5::GetDumpFile-Methode (dbgeng.h)

Artikel
02/23/2024

Die GetDumpFile-Methode beschreibt die Dateien mit unterstützenden Informationen, die beim Öffnen des aktuellen Speicherabbildziels verwendet wurden.

Syntax

HRESULT GetDumpFile(
  [in]            ULONG    Index,
  [out, optional] PSTR     Buffer,
  [in]            ULONG    BufferSize,
  [out, optional] PULONG   NameSize,
  [out, optional] PULONG64 Handle,
  [out]           PULONG   Type
);

Parameter

[in] Index

Gibt an, welche Datei beschrieben werden soll. Index kann Werte zwischen null und der Anzahl der Dateien minus 1 annehmen. die Anzahl der Dateien mithilfe von GetNumberDumpFiles gefunden werden kann.

[out, optional] Buffer

Empfängt den Dateinamen. Wenn BufferNULL ist, werden diese Informationen nicht zurückgegeben.

[in] BufferSize

Gibt die Größe des Pufferpuffers in Zeichen an. Diese Größe enthält den Leerraum für das "\0"-Endzeichen.

[out, optional] NameSize

Empfängt die Größe des Dateinamens. Diese Größe enthält den Leerraum für das "\0"-Endzeichen. Wenn NameSizeNULL ist, werden diese Informationen nicht zurückgegeben.

[out, optional] Handle

Empfängt das Dateihandle der Datei. Wenn HandleNULL ist, werden diese Informationen nicht zurückgegeben.

[out] Type

Empfängt den Typ der Datei.

Rückgabewert

Diese Methode gibt möglicherweise auch Fehlerwerte zurück. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.

Hinweise

Weitere Informationen zu Absturzabbilddateien finden Sie unter Speicherabbilddateiziele.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	dbgeng.h (dbgeng.h einschließen)

Weitere Informationen

AddDumpInformationFile

AddDumpInformationFileWide

GetNumberDumpFiles

IDebugClient4

IDebugClient5

Freigeben über