Método IDebugSymbolGroup2::AddSymbol (dbgeng.h)
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. Name é examinado como uma expressão para determinar o tipo de 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 deve apontar para o índice do símbolo desejado. Ou, se Índice apontar para DEBUG_ANY_ID, o símbolo será acrescentado ao final da lista.
Quando esse método retorna, Índice 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.
Valor de retorno
| Código de retorno | Descrição |
|---|---|
|
O método foi bem-sucedido. |
Esse método também pode retornar valores de erro. Para obter mais informações, consulte Valores retornados.
Observações
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.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | dbgeng.h (inclua Dbgeng.h) |