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

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 oscila entre cero y el número de símbolos del grupo de símbolos menos uno.

[out, optional] Buffer

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

[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, no se devuelve esta información.

Valor devuelto

Código devuelto	Descripción
S_OK	El método se realizó correctamente.
S_FALSE	El método se realizó correctamente. Sin embargo, el valor del símbolo no cabería en el búfer al que hace referencia el parámetro buffer de, 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.

Observaciones

Si agregó el símbolo al grupo de símbolos mediante el método addSymbol de, 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.

Requisitos

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

Consulte también

GetNumberSymbols

IDebugSymbolGroup2

WriteSymbol