IDebugSymbolGroup::OutputAsType-Methode (dbgeng.h)

Artikel
02/23/2024

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 Typs 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.

Hinweise

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

Wenn Type 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 in keiner Weise bearbeiten. Wenn beispielsweise der Name einer Variablen @$teb ist, können Sie ihren Typ in !teb ändern.

Weitere Informationen zu Symbolgruppen finden Sie unter Bereiche und Symbolgruppen.