Méthode IDebugSymbolGroup2 ::AddSymbol (dbgeng.h)

Article
02/23/2024

La méthode AddSymbol ajoute un symbole à un groupe de symboles.

Syntaxe

HRESULT AddSymbol(
  [in]      PCSTR  Name,
  [in, out] PULONG Index
);

Paramètres

[in] Name

Nom du symbole. Name est examiné en tant qu’expression pour déterminer le type du symbole. Cette expression peut inclure le déréférencement de pointeur, de tableau et de structure (par exemple, *my_pointer, my_array[1] ou my_struct.some_field).

[in, out] Index

Index de l’entrée dans le groupe de symboles. Lorsque vous appelez AddSymbol ou AddSymbolWide, Index doit pointer vers l’index du symbole souhaité. Ou, si Index pointe vers DEBUG_ANY_ID, le symbole est ajouté à la fin de la liste.

Lorsque cette méthode retourne, Index pointe vers l’index réel du symbole. L’index d’un symbole est un numéro d’identification. L’index est compris entre zéro et le nombre de symboles dans le groupe de symboles moins un.

Valeur retournée

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

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

Remarques

Le nom du symbole dans Nom est évalué par l’évaluateur d’expression C++ et peut contenir n’importe quelle expression C++ (par exemple, x+y).

Si l’index souhaité est inférieur à la taille du groupe de symboles, le nouveau symbole est ajouté à l’index souhaité. Si l’index souhaité est supérieur à la taille du groupe de symboles, le nouveau symbole est ajouté à la fin de la liste (comme dans le cas de DEBUG_ANY_ID).

Pour plus d’informations sur les groupes de symboles, consultez Étendues et Groupes de symboles.