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

Статья
02/06/2025

Метод GetSymbolValueText возвращает строку, представляющую значение символа.

Синтаксис

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

Параметры

[in] Index

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

[out, optional] Buffer

Значение символа в виде строки. Если буферnull, эти сведения не возвращаются.

[in] BufferSize

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

[out, optional] NameSize

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

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

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

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

Замечания

Если вы добавили символ в группу символов с помощью метода AddSymbol, строка, возвращаемая в буфер , — это имя символа, передаваемого в AddSymbol.

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