IDebugSymbols3 ::GetSourceEntriesByLineWide, méthode (dbgeng.h)

Article
02/06/2025

La méthode GetSourceEntriesByLineWide interroge les informations de symboles et retourne des emplacements dans la mémoire de la cible qui correspondent aux lignes d’un fichier source.

Syntaxe

HRESULT GetSourceEntriesByLineWide(
  [in]            ULONG                      Line,
  [in]            PCWSTR                     File,
  [in]            ULONG                      Flags,
  [out, optional] PDEBUG_SYMBOL_SOURCE_ENTRY Entries,
  [in]            ULONG                      EntriesCount,
  [out, optional] PULONG                     EntriesAvail
);

Paramètres

[in] Line

Spécifie la ligne dans le fichier source pour lequel interroger. Le nombre de la première ligne est 1.

[in] File

Spécifie le fichier source. Les symboles de chaque module de la cible sont interrogés pour ce fichier.

[in] Flags

Spécifie les indicateurs de bits qui contrôlent le comportement de cette méthode. indicateurs peut être n’importe quelle combinaison de valeurs du tableau suivant.

Valeur	Description
DEBUG_GSEL_NO_SYMBOL_LOADS	Le moteur de débogueur recherche uniquement le fichier parmi les modules dont les symboles ont déjà été chargés. Les symboles des autres modules ne seront pas chargés. Si cette option n’est pas définie, le moteur du débogueur charge les symboles de tous les modules jusqu’à ce qu’il trouve le fichier spécifié dans fichier.
DEBUG_GSEL_ALLOW_LOWER	Incluez toutes les lignes dans fichier avant ligne dans le résultat.
DEBUG_GSEL_ALLOW_HIGHER	Incluez toutes les lignes dans fichier après ligne dans le résultat.
DEBUG_GSEL_NEAREST_ONLY	Retourne uniquement au maximum un résultat. Si DEBUG_GSEL_ALLOW_LOWER ou DEBUG_GSEL_ALLOW_HIGHER sont définis, le résultat retourné est destiné à une ligne proche de ligne, mais ne peut pas être ligne s’il n’y a pas d’informations de symbole pour cette ligne.

Pour utiliser le jeu d’indicateurs par défaut, définissez indicateurs sur DEBUG_GSEL_DEFAULT. Tous les indicateurs du tableau précédent sont désactivés.

[out, optional] Entries

Reçoit les emplacements dans la mémoire de la cible correspondant aux lignes sources interrogées. Chaque entrée de ce tableau est de type DEBUG_SYMBOL_SOURCE_ENTRY et contient le numéro de ligne source ainsi qu’un emplacement dans la mémoire de la cible.

[in] EntriesCount

Spécifie le nombre d’entrées dans le tableau Entrées.

[out, optional] EntriesAvail

Reçoit le nombre d’emplacements correspondant à la requête trouvée dans la mémoire de la cible.

Valeur de retour

Ces méthodes peuvent é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 entrées tableau n’étaient pas suffisamment volumineuses pour contenir tous les résultats correspondant à la requête et les résultats supplémentaires ont été ignorés.
E_NOINTERFACE	La requête n’a produit aucun résultat. Cela inclut le cas où les informations de symbole n’étaient pas disponibles pour le fichier spécifié.

Remarques

Ces méthodes peuvent être utilisées par les applications de débogueur pour extraire des emplacements dans la mémoire de la cible pour définir des points d’arrêt ou correspondre au code source avec des instructions désassemblé. Par exemple, la définition des indicateurs DEBUG_GSEL_ALLOW_HIGHER et DEBUG_GSEL_NEAREST_ONLY retourne l’emplacement de mémoire de la cible pour le premier élément de code commençant à la ligne spécifiée.

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