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
符號的值做為字串。 如果 Buffer 是 NULL,則不會傳回這項資訊。
[in] BufferSize
緩衝區緩衝區的大小,以字元為單位。 此大小包含 『\0』 終止字元的空間。
[out, optional] NameSize
符號值的大小,以字元為單位。 此大小包含 『\0』 終止字元的空間。 如果 NameSize 為 NULL,則不會傳回此資訊。
傳回值
傳回碼 | 描述 |
---|---|
|
此方法成功。 |
|
此方法成功。 不過,符號的值不符合 Buffer 參數所參考的緩衝區,因此會傳回截斷的值。 |
這個方法也可以傳回錯誤值。 如需詳細資訊,請參閱 傳回值。
備註
如果您使用 AddSymbol 方法將符號新增至符號群組,則傳回 Buffer 的 字串是傳遞 至 AddSymbol 的符號名稱。
如需符號群組的詳細資訊,請參閱 範圍和符號群組。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | dbgeng.h (包含 Dbgeng.h) |