Partager via


Méthode IDebugSymbols2 ::GetNextSymbolMatch (dbgeng.h)

La méthode GetNextSymbolMatch retourne le symbole suivant trouvé dans une recherche de symboles.

Syntaxe

HRESULT GetNextSymbolMatch(
  [in]            ULONG64  Handle,
  [out, optional] PSTR     Buffer,
  [in]            ULONG    BufferSize,
  [out, optional] PULONG   MatchSize,
  [out, optional] PULONG64 Offset
);

Paramètres

[in] Handle

Spécifie le handle retourné par StartSymbolMatch lors de l’initialisation de la recherche.

[out, optional] Buffer

Reçoit le nom du symbole. Si Buffer a la valeur NULL, le même symbole sera retourné la prochaine fois que l’une de ces méthodes sera appelée (avec le même handle) ; cela peut être utilisé pour déterminer la taille du nom du symbole.

[in] BufferSize

Spécifie la taille en caractères de la mémoire tampon. Cette taille inclut l’espace pour le caractère de fin « \0 ».

[out, optional] MatchSize

Reçoit la taille en caractères du nom du symbole. Cette taille inclut l’espace pour le caractère de fin « \0 ». Si MatchSize a la valeur NULL, ces informations ne sont pas retournées.

[out, optional] Offset

Reçoit l’emplacement du symbole dans l’espace d’adressage virtuel de la cible. Si Offset a la valeur NULL, ces informations ne sont pas retournées.

Valeur retournée

Cette méthode peut également retourner d’autres 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 taille de la mémoire tampon était trop petite pour le nom du symbole, ou la mémoire tampon était NULL.
E_NOINTERFACE
Aucun autre symbole correspondant au modèle n’a été trouvé.

Remarques

La recherche doit d’abord être initialisée par StartSymbolMatch. Une fois que tous les symboles souhaités ont été trouvés, EndSymbolMatch peut être utilisé pour libérer les ressources que le moteur détient pour la recherche.

Pour plus d’informations sur les symboles, consultez Symboles.

Configuration requise

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

Voir aussi

EndSymbolMatch

IDebugSymbols

IDebugSymbols2

IDebugSymbols3

StartSymbolMatch