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

El método GetSymbolName devuelve el nombre de un símbolo en 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 va desde cero hasta el número de símbolos del grupo de símbolos menos uno.

[out, optional] Buffer

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

[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, 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 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 (include Dbgeng.h)

Consulte también

GetNumberSymbols

IDebugSymbolGroup

IDebugSymbolGroup2