Метод IDebugSymbols3::GetSymbolEntryString (dbgeng.h)

  • Статья

Метод GetSymbolEntryString возвращает сведения о строке для указанного символа.

Синтаксис

HRESULT GetSymbolEntryString(
  [in]            PDEBUG_MODULE_AND_ID Id,
  [in]            ULONG                Which,
  [out, optional] PSTR                 Buffer,
  [in]            ULONG                BufferSize,
  [out, optional] PULONG               StringSize
);

Параметры

[in] Id

Указывает символы, области памяти которых запрашиваются. Структура DEBUG_MODULE_AND_ID содержит модуль, содержащий символ и идентификатор символа в модуле.

[in] Which

Указывает индекс требуемой строки. Часто это ноль, так как большинство символов содержат только одну строку (их имя). Но некоторые символы могут содержать несколько строк, например символы заметок.

[out, optional] Buffer

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

[in] BufferSize

Задает размер буфера буфера в символах. Этот размер включает пробел для завершающего символа "\0".

[out, optional] StringSize

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

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

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

Код возврата Описание
S_OK
 Метод выполнен успешно.

Комментарии

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

Требования

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

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

GetSymbolEntriesByName

GetSymbolEntriesByOffset

IDebugSymbols3