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

Article
02/06/2025

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

Syntaxe

HRESULT GetNextSymbolMatchWide(
  [in]            ULONG64  Handle,
  [out, optional] PWSTR    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 de mémoire tampon est NULL, le même symbole est retourné à nouveau la prochaine fois qu’une de ces méthodes est 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 du caractère de fin « \0 ».

[out, optional] MatchSize

Reçoit la taille en caractères du nom du symbole. Cette taille inclut l’espace du caractère de fin « \0 ». Si MatchSize est 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 est NULL, ces informations ne sont pas retournées.

Valeur de retour

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

Remarques

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

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