IDebugSymbolGroup ::AddSymbol, méthode (dbgeng.h)

Article
02/06/2025

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. Nom est examiné en tant qu’expression pour déterminer le type du symbole. Cette expression peut inclure le déreferencing pointeur, tableau et 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 devez 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 est retournée, 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 de retour

Retourner le code	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 de 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.