IDebugSymbolGroup2::AddSymbol-Methode (dbgeng.h)
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 |
---|---|
|
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.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Desktop |
Kopfzeile | dbgeng.h (einschließlich Dbgeng.h) |