IDebugSymbols ::StartSymbolMatch, méthode (dbgeng.h)

Article
02/06/2025

La méthode StartSymbolMatch initialise une recherche de symboles dont les noms correspondent à un modèle donné.

Syntaxe

HRESULT StartSymbolMatch(
  [in]  PCSTR    Pattern,
  [out] PULONG64 Handle
);

Paramètres

[in] Pattern

Spécifie le modèle pour lequel effectuer une recherche. La recherche retourne tous les symboles dont les noms correspondent à ce modèle. Pour plus d’informations sur la syntaxe du modèle, consultez Syntaxe des symboles et correspondance des symboles et syntaxe de caractères génériques de chaîne.

[out] Handle

Reçoit le handle identifiant la recherche. Ce handle peut être passé à GetNextSymbolMatch et EndSymbolMatch.

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.
E_NOINTERFACE	Le module spécifié est introuvable.

Remarques

Cette méthode initialise une recherche de symboles. Les résultats de la recherche peuvent être obtenus par des appels répétés à GetNextSymbolMatch. Lorsque tous les résultats souhaités ont été trouvés, utilisez EndSymbolMatch pour libérer les ressources que le moteur contient pour la recherche.

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