IDebugAdvanced2::GetSourceFileInformation-Methode (dbgeng.h)
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 |
---|---|
|
Die Methode war erfolgreich. |
|
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) |