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

Article
02/23/2024

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.