IDebugAdvanced3::GetSourceFileInformation-Methode (dbgeng.h)

Artikel
02/26/2024

Die GetSourceFileInformation-Methode gibt angegebene Informationen zu einer Quelldatei zurück.

Syntax

HRESULT GetSourceFileInformation(
  [in]            ULONG   Which,
  [in]            PSTR    SourceFile,
  [in]            ULONG64 Arg64,
  [in]            ULONG   Arg32,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  InfoSize
);

Parameter

[in] Which

Gibt die zurückzugebende Information an. Der Parameter Which kann einen der Werte in der folgenden Tabelle annehmen.

DEBUG_SRCFILE_SYMBOL_TOKEN

Gibt ein Token zurück, das die angegebene Quelldatei auf einem Quellserver darstellt. Dieses Token kann an FindSourceFileAndToken übergeben werden, um Informationen zur Datei abzurufen. Das Token wird als Bytearray an den Pufferpuffer zurückgegeben. Die Größe dieses Tokens spiegelt die Größe des SrcSrv-Tokens wider.

DEBUG_SRCFILE_SYMBOL_TOKEN_SOURCE_COMMAND_WIDE

Fragt einen Quellserver nach dem Befehl ab, um die Quelldatei aus der Quellcodeverwaltung zu extrahieren. Dies schließt den Namen der ausführbaren Datei und deren Befehlszeilenparameter ein. Der Befehl wird als Unicode-Zeichenfolge an den Pufferpuffer zurückgegeben.

[in] SourceFile

Gibt die Quelldatei an, deren Informationen angefordert werden. Die Quelldatei wird auf allen Quellservern im Quellpfad gesucht.

[in] Arg64

Gibt ein 64-Bit-Argument an. Der Wert von Gibt das Modul an, dessen Symboltoken angefordert wird. Unabhängig vom Wert von Which ist Arg64 ein Speicherort innerhalb der Speicherbelegung des Moduls.

[in] Arg32

Gibt ein 32-Bit-Argument an. Dieser Parameter wird derzeit nicht verwendet.

[out, optional] Buffer

Empfängt die angeforderten Symbolinformationen. Der Typ der zurückgegebenen Daten hängt vom Wert von Which ab. Wenn PufferNULL ist, werden diese Informationen nicht zurückgegeben.

[in] BufferSize

Gibt die Größe des Pufferpuffers in Bytes an. Wenn BufferNULL ist, muss BufferSize ebenfalls NULL sein.

[out, optional] InfoSize

Gibt die Größe der an den Pufferpuffer zurückgegebenen Informationen in Bytes an. Dieser Parameter kann NULL sein, wenn die Daten nicht erforderlich sind.

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.
S_FALSE	Die Methode war erfolgreich. Die Informationen passen jedoch nicht in den Pufferpuffer , sodass die Informationen oder der Name abgeschnitten wurden.

Hinweise

Weitere Informationen zu Quelldateien finden Sie unter Verwenden von Quelldateien.

Anforderungen

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

Weitere Informationen

FindSourceFileAndToken

IDebugAdvanced2

IDebugAdvanced3

Freigeben über