Método IDebugSymbolGroup2::AddSymbol (dbgeng.h)

Artigo
02/26/2024

O método AddSymbol adiciona um símbolo a um grupo de símbolos.

Sintaxe

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

Parâmetros

[in] Name

O nome do símbolo. O nome é examinado como uma expressão para determinar o tipo do símbolo. Essa expressão pode incluir desreferenciamento de ponteiro, matriz e estrutura (por exemplo, *my_pointer, my_array[1]ou my_struct.some_field).

[in, out] Index

O índice da entrada no grupo de símbolos. Quando você estiver chamando AddSymbol ou AddSymbolWide, Index deverá apontar para o índice do símbolo desejado. Ou, se Index apontar para DEBUG_ANY_ID, o símbolo será acrescentado ao final da lista.

Quando esse método retorna, Index aponta para o índice real do símbolo. O índice de um símbolo é um número de identificação. O índice varia de zero até o número de símbolos no grupo de símbolos menos um.

Retornar valor

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Esse método também pode retornar valores de erro. Para obter mais informações, consulte Valores retornados.

Comentários

O nome do símbolo em Name é avaliado pelo avaliador de expressão C++ e pode conter qualquer expressão C++ (por exemplo, x+y).

Se o índice desejado for menor que o tamanho do grupo de símbolos, o novo símbolo será adicionado ao índice desejado. Se o índice desejado for maior que o tamanho do grupo de símbolos, o novo símbolo será adicionado ao final da lista (como no caso de DEBUG_ANY_ID).

Para obter mais informações sobre grupos de símbolos, consulte Escopos e grupos de símbolos.