Méthode IDebugAdvanced3 ::GetSourceFileInformation (dbgeng.h)

Article
02/26/2024

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 paramètre Qui 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 passé à FindSourceFileAndToken pour récupérer des informations sur le fichier. Le jeton est retourné à la mémoire tampon sous la forme d’un tableau d’octets. La taille de ce jeton reflète 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 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 Which spécifie le module dont le jeton de symbole est demandé. Quelle que soit la valeur de Which, 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 La mémoire tampon a la valeur NULL, ces informations ne sont pas retournées.

[in] BufferSize

Spécifie la taille en octets de la mémoire tampon . Si La mémoire tampon a la valeur NULL, BufferSize doit également avoir la valeur NULL.

[out, optional] InfoSize

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

Valeur retournée

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

Code de retour	Description
S_OK	La méthode a réussi.
S_FALSE	La méthode a réussi. Toutefois, les informations ne rentrent pas dans la mémoire 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.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	dbgeng.h (inclure Dbgeng.h)

Voir aussi

FindSourceFileAndToken

IDebugAdvanced2

IDebugAdvanced3

Partager via