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


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

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

Синтаксис

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

Параметры

[in] Index

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

[out, optional] Buffer

Значение символа в виде строки. Если параметр Buffer имеет значение NULL, эта информация не возвращается.

[in] BufferSize

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

[out, optional] NameSize

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

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

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

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

Комментарии

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

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

Требования

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

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

GetNumberSymbols

IDebugSymbolGroup2

WriteSymbol