PENUMSOURCEFILETOKENSCALLBACK-Rückruffunktion (dbghelp.h)

Artikel
08/23/2023

Eine anwendungsdefinierte Rückruffunktion, die mit der SymEnumSourceFileTokens-Funktion verwendet wird, die die versionskontrollinformationen des Quellservers auflistet, die im PDB für ein Modul gespeichert sind.

Der PENUMSOURCEFILETOKENSCALLBACK-Typ definiert einen Zeiger auf diese Rückruffunktion. SymEnumSourceFileTokensProc ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.

Syntax

PENUMSOURCEFILETOKENSCALLBACK Penumsourcefiletokenscallback;

BOOL Penumsourcefiletokenscallback(
  [in] PVOID token,
  [in] size_t size
)
{...}

Parameter

[in] token

Ein Zeiger auf eine undurchsichtige Datenstruktur, die die Versionskontrollinformationen für eine bestimmte einzelne Quelldatei enthält. Die Verwendung dieses Tokens wird unten beschrieben.

[in] size

Die Größe der Daten im Tokenparameter .

Rückgabewert

Wenn die Funktion TRUE zurückgibt, wird die Enumeration fortgesetzt.

Wenn die Funktion FALSE zurückgibt, wird die Enumeration beendet.

Hinweise

Eine Anwendung kann dieses Token verwenden, um eine Quelldatei aus der Versionskontrolle zu extrahieren, indem SymGetSourceFileFromToken aufgerufen wird.

Um einzelne Variablen aus dem Token abzurufen, rufen Sie SymGetSourceVarFromToken auf. Die Namen der Variablen unterscheiden sich je nach den Skripts, die zum Erstellen der Token verwendet werden. Weitere Informationen finden Sie unter Quellserver .