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

Artículo
02/26/2024

El método GetSymbolValueText devuelve una cadena que representa el valor de un símbolo.

Sintaxis

HRESULT GetSymbolValueText(
  [in]            ULONG  Index,
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG NameSize
);

Parámetros

[in] Index

Índice del símbolo cuyo valor desea. El índice de un símbolo es un número de identificación. El índice va desde cero hasta el número de símbolos del grupo de símbolos menos uno.

[out, optional] Buffer

Valor del símbolo como una cadena. Si El búfer es NULL, esta información no se devuelve.

[in] BufferSize

Tamaño, en caracteres, del búfer de búfer . Este tamaño incluye el espacio para el carácter de terminación '\0'.

[out, optional] NameSize

Tamaño, en caracteres, del valor del símbolo. Este tamaño incluye el espacio para el carácter de terminación '\0'. Si NameSize es NULL, esta información no se devuelve.

Valor devuelto

Código devuelto	Descripción
S_OK	Método realizado correctamente.
S_FALSE	Método realizado correctamente. Sin embargo, el valor del símbolo no cabría en el búfer al que hace referencia el parámetro Buffer , por lo que se devolvió un valor truncado.

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

Comentarios

Si agregó el símbolo al grupo de símbolos mediante el método AddSymbol , la cadena que se devuelve a Buffer es el nombre del símbolo que se pasa a AddSymbol.

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