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

Artículo
08/07/2023

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

El nombre del símbolo. El nombre se examina como una expresión para determinar el tipo del símbolo. Esta expresión puede incluir puntero, matriz y desreferenciación 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	Método realizado correctamente.

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

Comentarios

El evaluador de expresiones de C++ evalúa el nombre del símbolo en Name 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.