IDebugSymbolGroup2::OutputAsType-Methode (dbgeng.h)

Artikel
02/06/2025

Die OutputAsType Methode ändert den Typ eines Symbols in einer Symbolgruppe. Der Eintrag des Symbols wird aktualisiert, um den neuen Typ darzustellen.

Syntax

HRESULT OutputAsType(
  [in] ULONG Index,
  [in] PCSTR Type
);

Parameter

[in] Index

Der Index des Eintrags in dieser Symbolgruppe. Der Index eines Symbols ist eine Identifikationsnummer. Der Index reicht von Null bis zur Anzahl der Symbole in der Symbolgruppe minus 1.

[in] Type

Der Name des gewünschten Symbols. Wenn der Name mit einem Ausrufezeichen (!) beginnt, wird der Name als Erweiterung behandelt. Weitere Informationen zur Verwendung einer Erweiterung als Typ finden Sie im Abschnitt "Hinweise".

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

Da sich die untergeordneten Elemente des neuen Eintragstyps von den untergeordneten Elementen des alten Eintragstyps unterscheiden können, entfernt die OutputAsType- methode alle untergeordneten Elemente des Eintrags aus der Symbolgruppe. Sie können die untergeordneten Elemente wieder hinzufügen, indem Sie die ExpandSymbol--Methode verwenden.

Wenn Typ eine Erweiterung ist, wird die Adresse des Symbols an die Erweiterung übergeben. Jede Ausgabezeile der Erweiterung wird zu einem untergeordneten Symbol des angegebenen Symbols. Diese untergeordneten Symbole sind Text, und Sie können sie nicht auf irgendeine Weise bearbeiten. Wenn beispielsweise der Name einer Variablen @$tebist, können Sie den Typ in !teb-ändern.

Weitere Informationen zu Symbolgruppen finden Sie unter Bereiche und Symbolgruppen.