Compartir a través de


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

El método AddSymbol agrega un símbolo a un grupo de símbolos .

Sintaxis

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

Parámetros

[in] Name

Nombre del símbolo. Nombre se examina como una expresión para determinar el tipo de del símbolo. Esta expresión puede incluir puntero, matriz y desreferencia de estructura (por ejemplo, *my_pointer, my_array[1]o my_struct.some_field).

[in, out] Index

Índice de la entrada en el grupo de símbolos. Al llamar a AddSymbol o AddSymbolWide, Index debe apuntar al índice del símbolo que desee. O bien, si index apunta a DEBUG_ANY_ID, el símbolo se anexa al final de la lista.

Cuando este método devuelve, Index apunta al índice real del símbolo. El índice de un símbolo es un número de identificación. El índice oscila entre cero y el número de símbolos del grupo de símbolos menos uno.

Valor devuelto

Código devuelto Descripción
S_OK
El método se realizó correctamente.
 

Este método también puede devolver valores de error. Para obtener más información, vea valores devueltos.

Observaciones

El nombre de símbolo de Nombre se evalúa mediante el evaluador de expresiones de C++ de y puede contener cualquier expresión de C++ (por ejemplo, x+y).

Si el índice que desea es menor que el tamaño del grupo de símbolos, el nuevo símbolo se agrega en el índice deseado. Si el índice deseado es mayor que el tamaño del grupo de símbolos, el nuevo símbolo se agrega al final de la lista (como en el caso de DEBUG_ANY_ID).

Para obtener más información sobre los grupos de símbolos, vea Ámbitos y grupos de símbolos.

Requisitos

Requisito Valor
de la plataforma de destino de Escritorio
encabezado de dbgeng.h (include Dbgeng.h)

Consulte también

GetNumberSymbols

IDebugSymbolGroup

IDebugSymbolGroup2

removeSymbolByIndex

RemoveSymbolByName