IDebugSymbolGroup2::OutputAsTypeWide-Methode (dbgeng.h)

Artikel
02/26/2024

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

Syntax

HRESULT OutputAsTypeWide(
  [in] ULONG  Index,
  [in] PCWSTR 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 von den untergeordneten Elementen des alten Eintragstyps unterscheiden können, entfernt die OutputAsTypeWide-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.