Metodo IDebugSymbolGroup2::AddSymbol (dbgeng.h)

Articolo
02/23/2024

Il metodo AddSymbol aggiunge un simbolo a un gruppo di simboli.

Sintassi

HRESULT AddSymbol(
  [in]      PCSTR  Name,
  [in, out] PULONG Index
);

Parametri

[in] Name

Nome del simbolo. Il nome viene esaminato come espressione per determinare il tipo del simbolo. Questa espressione può includere puntatore, matrice e dereferencing della struttura, ad esempio *my_pointer, my_array[1], o my_struct.some_field.

[in, out] Index

Indice della voce nel gruppo di simboli. Quando si chiama AddSymbol o AddSymbolWide, Index deve puntare all'indice del simbolo desiderato. In alternativa, se Indice punta a DEBUG_ANY_ID, il simbolo viene aggiunto alla fine dell'elenco.

Quando questo metodo restituisce, Index punta all'indice effettivo del simbolo. L'indice di un simbolo è un numero di identificazione. L'indice varia da zero al numero di simboli nel gruppo di simboli meno uno.

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

Il nome del simbolo in Name viene valutato dall'analizzatore di espressioni C++ e può contenere qualsiasi espressione C++ (ad esempio x+y).

Se l'indice desiderato è minore delle dimensioni del gruppo di simboli, il nuovo simbolo viene aggiunto all'indice desiderato. Se l'indice desiderato è maggiore della dimensione del gruppo di simboli, il nuovo simbolo viene aggiunto alla fine dell'elenco, come nel caso di DEBUG_ANY_ID.

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