Metodo IDebugSymbolGroup::OutputAsType (dbgeng.h)

Articolo
08/07/2023

Il metodo OutputAsType modifica il tipo di un simbolo in un gruppo di simboli. La voce del simbolo viene aggiornata per rappresentare il nuovo tipo.

Sintassi

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

Parametri

[in] Index

Indice della voce in questo gruppo di simboli. L'indice di un simbolo è un numero di identificazione. L'indice varia da zero al numero di simboli nel gruppo di simboli meno uno.

[in] Type

Nome del tipo del simbolo desiderato. Se il nome inizia con un segno esclamativo (!), il nome viene considerato come estensione. Per altre informazioni su come usare un'estensione come tipo, vedere la sezione Osservazioni.

Valore restituito

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.

Questo metodo può anche restituire valori di errore. Per altre informazioni, vedere Valori restituiti.

Commenti

Poiché gli elementi figlio del nuovo tipo di voce potrebbero essere diversi dagli elementi figlio del tipo di voce precedente, il metodo OutputAsType rimuove tutti gli elementi figlio della voce dal gruppo di simboli. È possibile aggiungere di nuovo gli elementi figlio usando il metodo ExpandSymbol .

Se Type è un'estensione, l'indirizzo del simbolo viene passato all'estensione. Ogni riga di output dall'estensione diventa un simbolo figlio del simbolo specificato. Questi simboli figlio sono testo e non è possibile modificarli in alcun modo. Ad esempio, se il nome di una variabile è @$teb, è possibile modificarlo in !teb.

Per altre informazioni sui gruppi di simboli, vedere Ambiti e gruppi di simboli.