Método IDebugSymbolGroup::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 Buffer 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	Método realizado correctamente.
S_FALSE	Método realizado 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.

Comentarios

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

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	dbgeng.h (incluir Dbgeng.h)

Consulte también

GetNumberSymbols

IDebugSymbolGroup

IDebugSymbolGroup2