Поделиться через


Метод IDebugSymbolGroup::GetSymbolName (dbgeng.h)

Метод GetSymbolName возвращает имя символа в группе символов.

Синтаксис

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

Параметры

[in] Index

Индекс символа, имя которого требуется. Индекс символа — это идентификационный номер. Индекс в диапазоне от нуля до количества символов в группе символов минус один.

[out, optional] Buffer

Имя символа. Если параметр Buffer имеет значение NULL, эти сведения не возвращаются.

[in] BufferSize

Размер буфера, на который указывает buffer . Этот размер включает пробел для завершающего символа "\0".

[out, optional] NameSize

Размер имени символа. Этот размер включает пробел для завершающего символа "\0". Если параметр NameSize имеет значение NULL, эти сведения не возвращаются.

Возвращаемое значение

Код возврата Описание
S_OK
Метод выполнен успешно.
S_FALSE
Метод выполнен успешно. Однако имя символа не помещается в буфер, на который ссылается параметр Buffer , поэтому было возвращено усеченное имя.
 

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения.

Комментарии

Дополнительные сведения о группах символов см. в разделе Области и группы символов.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть dbgeng.h (включая Dbgeng.h)

См. также раздел

GetNumberSymbols

IDebugSymbolGroup

IDebugSymbolGroup2