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

Article
02/26/2024

La méthode StartSymbolMatch initialise une recherche de symboles dont le nom correspond à 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 le nom correspond à ce modèle. Pour plus d’informations sur la syntaxe du modèle, consultez Syntaxe des symboles et Correspondance de symboles et Syntaxe générique de chaîne.

[out] Handle

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

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.
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.