IDebugSymbolGroup::AddSymbol-Methode (dbgeng.h)

Artikel
02/06/2025

Die AddSymbol--Methode fügt einer Symbolgruppeein Symbol hinzu.

Syntax

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

Parameter

[in] Name

Der Name des Symbols. Name wird als Ausdruck untersucht, um den Typ des Symbolszu bestimmen. Dieser Ausdruck kann Zeiger, Array und Strukturausleitung umfassen (z. B. *my_pointer, my_array[1]oder my_struct.some_field).

[in, out] Index

Der Index des Eintrags in der Symbolgruppe. Wenn Sie AddSymbol oder AddSymbolWide-aufrufen, sollte Index- auf den Index des gewünschten Symbols zeigen. Wenn Index auf DEBUG_ANY_ID zeigt, wird das Symbol an das Ende der Liste angefügt.

Wenn diese Methode zurückgegeben wird, zeigt Index auf den tatsächlichen Index des Symbols. Der Index eines Symbols ist eine Identifikationsnummer. Der Index reicht von Null bis zur Anzahl der Symbole in der Symbolgruppe minus 1.

Rückgabewert

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Bemerkungen

Der Symbolname in Name wird vom C++-Ausdruck evaluator ausgewertet und kann einen beliebigen C++-Ausdruck enthalten (z. B. x+y).

Wenn der gewünschte Index kleiner als die Größe der Symbolgruppe ist, wird das neue Symbol am gewünschten Index hinzugefügt. Wenn der gewünschte Index größer als die Größe der Symbolgruppe ist, wird das neue Symbol am Ende der Liste hinzugefügt (wie bei DEBUG_ANY_ID).

Weitere Informationen zu Symbolgruppen finden Sie unter Bereiche und Symbolgruppen.