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

El método getSymbolName devuelve el nombre de un símbolo de un grupo de símbolos.

Sintaxis

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

Parámetros

[in] Index

Índice del símbolo cuyo nombre 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

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

[in] BufferSize

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

[out, optional] NameSize

Tamaño del nombre 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 nombre del símbolo no cabe en el búfer al que hace referencia el parámetro Buffer, por lo que se devolvió un nombre truncado.

 

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

Observaciones

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