Metodo IDebugSymbolGroup::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 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 è compreso tra zero e il 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 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.