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

Статья
08/07/2023

Метод 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 , поэтому было возвращено усеченное имя.