Metodo IDebugSymbolGroup2::OutputAsTypeWide (dbgeng.h)

Articolo
02/06/2025

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

Sintassi

HRESULT OutputAsTypeWide(
  [in] ULONG  Index,
  [in] PCWSTR 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 punto 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 ha avuto esito positivo.

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

Osservazioni

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

Se Tipo è un'estensione, l'indirizzo del simbolo viene passato all'estensione. Ogni riga di output dell'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 modificarne il tipo in !teb.

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