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

Article
02/23/2024

La méthode GetSymbolEntriesByName retourne les symboles dont les noms correspondent à un modèle donné.

Syntaxe

HRESULT GetSymbolEntriesByName(
  [in]            PCSTR                Symbol,
  [in]            ULONG                Flags,
  [out, optional] PDEBUG_MODULE_AND_ID Ids,
  [in]            ULONG                IdsCount,
  [out, optional] PULONG               Entries
);

Paramètres

[in] Symbol

Spécifie le modèle utilisé pour déterminer les symboles à retourner. Cette méthode retourne les symboles dont le nom correspond au modèle de syntaxe générique de chaîneSymbole.

[in] Flags

Définit la valeur zéro.

[out, optional] Ids

Reçoit les symboles. Il s’agit d’un tableau d’entrées IdsCount de type DEBUG_MODULE_AND_ID. Si IDs a la valeur NULL, ces informations ne sont pas retournées.

[in] IdsCount

Spécifie le nombre d’entrées que les ID de tableau peuvent contenir.

[out, optional] Entries

Reçoit le nombre de symboles dont les noms correspondent au modèle Symbole. Si les entrées ont la valeur NULL, ces informations ne sont pas retournées.

Valeur retournée

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez Valeurs de retour .

Code de retour	Description
S_OK	La méthode a réussi.

Remarques

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

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	dbgeng.h (inclure Dbgeng.h)

Voir aussi

GetSymbolEntriesByOffset

IDebugSymbols3