Méthode IDebugSymbols ::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 La mémoire tampon a la valeur NULL, le même symbole sera retourné à nouveau la prochaine fois qu’une de ces méthodes sera appelée (avec le même handle) ; vous pouvez l’utiliser 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 dans l’espace d’adressage virtuel de la cible du symbole. 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 tous les symboles souhaités trouvés, EndSymbolMatch peut être utilisé pour libérer les ressources que le moteur contient pour la recherche.

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