IDebugAdvanced3 ::GetSourceFileInformation, méthode (dbgeng.h)

Article
02/06/2025

La méthode GetSourceFileInformation retourne des informations spécifiées sur un fichier source.

Syntaxe

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
);

Paramètres

[in] Which

Spécifie l’élément d’informations à retourner. Le quel paramètre peut prendre l’une des valeurs du tableau suivant.

DEBUG_SRCFILE_SYMBOL_TOKEN

Retourne un jeton représentant le fichier source spécifié sur un serveur source. Ce jeton peut être transmis à FindSourceFileAndToken pour récupérer des informations sur le fichier. Le jeton est retourné à la mémoire tampon tampon en tant que tableau d’octets. La taille de ce jeton est une réflexion de la taille du jeton SrcSrv.

DEBUG_SRCFILE_SYMBOL_TOKEN_SOURCE_COMMAND_WIDE

Interroge un serveur source pour que la commande extrait le fichier source du contrôle de code source. Cela inclut le nom du fichier exécutable et ses paramètres de ligne de commande. La commande est retournée à la mémoire tampon tampon en tant que chaîne Unicode.

[in] SourceFile

Spécifie le fichier source dont les informations sont demandées. Le fichier source est recherché sur tous les serveurs sources dans le chemin d’accès source.

[in] Arg64

Spécifie un argument 64 bits. La valeur de Qui spécifie le module dont le jeton de symbole est demandé. Quelle que soit la valeur de Quel, Arg64 est un emplacement dans l’allocation de mémoire du module.

[in] Arg32

Spécifie un argument 32 bits. Ce paramètre n’est actuellement pas utilisé.

[out, optional] Buffer

Reçoit les informations de symbole demandées. Le type des données retournées dépend de la valeur de Laquelle. Si tampon est NULL, ces informations ne sont pas retournées.

[in] BufferSize

Spécifie la taille en octets de la mémoire tampon tampon. Si de mémoire tampon est NULL, BufferSize doit également être NULL.

[out, optional] InfoSize

Spécifie la taille en octets des informations retournées à la mémoire tampon tampon. Ce paramètre peut être NULL si les données ne sont pas requises.

Valeur de retour

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez valeurs de retour.

Retourner le code	Description
S_OK	La méthode a réussi.
S_FALSE	La méthode a réussi. Toutefois, les informations ne tiennent pas dans la mémoire tampon tampon, de sorte que les informations ou le nom ont été tronqués.

Remarques

Pour plus d’informations sur les fichiers sources, consultez Utilisation de fichiers sources.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	dbgeng.h (include Dbgeng.h)

Voir aussi

FindSourceFileAndToken

IDebugAdvanced2

IDebugAdvanced3

Partager via