Metodo IDebugSymbolGroup2::AddSymbol (dbgeng.h)

Articolo
02/06/2025

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. nome viene esaminato come espressione per determinare il tipo di del simbolo. Questa espressione può includere puntatore, matrice e dereferenziazione 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 Index punta a DEBUG_ANY_ID, il simbolo viene aggiunto alla fine dell'elenco.

Quando termina, 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 ha avuto esito positivo.

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

Osservazioni

Il nome del simbolo in Nome 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 in corrispondenza dell'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.