IDebugSymbolGroup2::GetSymbolValueText 方法 (dbgeng.h)

GetSymbolValueText 方法返回表示符号值的字符串。

语法

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

参数

[in] Index

所需值的符号的索引。 符号的索引是标识号。 索引的范围从零到符号组中的符号数减 1。

[out, optional] Buffer

符号作为字符串的值。 如果 BufferNULL,则不会返回此信息。

[in] BufferSize

缓冲区的大小(以字符为单位)。 此大小包括“\0”终止字符的空间。

[out, optional] NameSize

符号值的大小(以字符为单位)。 此大小包括“\0”终止字符的空间。 如果 NameSizeNULL,则不会返回此信息。

返回值

返回代码 说明
S_OK
方法成功。
S_FALSE
方法成功。 但是,符号的值不适合 Buffer 参数引用 的缓冲区中,因此返回截断的值。
 

此方法还可以返回错误值。 有关详细信息,请参阅 返回值

注解

如果使用 AddSymbol 方法将符号添加到符号组,则返回到 Buffer 的字符串是传递给 AddSymbol 的符号的名称。

有关符号组的详细信息,请参阅 作用域和符号组

要求

要求
目标平台 桌面
标头 dbgeng.h (包括 Dbgeng.h)

另请参阅

GetNumberSymbols

IDebugSymbolGroup2

WriteSymbol