IDebugAdvanced3::GetSourceFileInformation-Methode (dbgeng.h)

Artikel
02/06/2025

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 den zurückzugebenden Informationsteil 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 Buffer Puffer zurückgegeben. Die Größe dieses Tokens entspricht der Größe des SrcSrv-Tokens.

DEBUG_SRCFILE_SYMBOL_TOKEN_SOURCE_COMMAND_WIDE

Fragt einen Quellserver für den Befehl ab, um die Quelldatei aus der Quellcodeverwaltung zu extrahieren. Dies schließt den Namen der ausführbaren Datei und der zugehörigen Befehlszeilenparameter ein. Der Befehl wird als Unicode-Zeichenfolge an den Buffer Puffer zurückgegeben.

[in] SourceFile

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

[in] Arg64

Gibt ein 64-Bit-Argument an. Der Wert von Which gibt das Modul an, dessen Symboltoken angefordert wird. Unabhängig vom Wert von Whichist Arg64- ein Ort innerhalb der Speicherzuweisung 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 Whichab. Wenn Puffer-NULL-ist, werden diese Informationen nicht zurückgegeben.

[in] BufferSize

Gibt die Größe in Byte des Puffer- Puffers an. Wenn Puffer-NULL-ist, muss BufferSize- auch NULL-sein.

[out, optional] InfoSize

Gibt die Größe in Byte der Informationen an, die an den puffer Puffer zurückgegeben werden. Dieser Parameter kann NULL- werden, 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 würden jedoch nicht in den Puffer Puffer passen, sodass die Informationen oder der Name abgeschnitten wurden.

Bemerkungen

Weitere Informationen zu Quelldateien finden Sie unter Verwenden von Quelldateien.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	dbgeng.h (include Dbgeng.h)

Siehe auch

FindSourceFileAndToken

IDebugAdvanced2

IDebugAdvanced3

Freigeben über