IDebugSymbolGroup::AddSymbol-Methode (dbgeng.h)

Artikel
02/26/2024

Die AddSymbol-Methode fügt einer Symbolgruppe ein 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 Symbols zu bestimmen. Dieser Ausdruck kann Zeiger-, Array- und Strukturdereferencing enthalten (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. Oder, wenn Index auf DEBUG_ANY_ID zeigt, wird das Symbol an das Ende der Liste angefügt.

Wenn diese Methode zurückgibt, 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.

Hinweise

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

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.