IDebugSymbolGroup2::GetSymbolValueText 方法 (dbgeng.h)

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 方法将符号添加到符号组中,则返回到 Buffer 的字符串是传递给 addSymbol 的符号的名称。

有关符号组的详细信息,请参阅 范围和符号组

要求

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

另请参阅

GetNumberSymbols

IDebugSymbolGroup2

WriteSymbol