IDebugDataSpaces4::ReadTagged 方法 (dbgeng.h)
ReadTagged 方法读取可能与调试器会话关联的标记数据。
语法
HRESULT ReadTagged(
[in] LPGUID Tag,
[in] ULONG Offset,
[out, optional] PVOID Buffer,
[in] ULONG BufferSize,
[out, optional] PULONG TotalSize
);
参数
[in] Tag
指定标识所请求数据的 GUID。
[in] Offset
指定要读取的数据中的偏移量。
[out, optional] Buffer
接收数据。 如果 Buffer 为 NULL,则不返回数据。
[in] BufferSize
指定缓冲区 缓冲区的大小(以字节为单位)。 这是将返回的最大字节数。
[out, optional] TotalSize
接收 Tag 指定的数据的总大小(以字节为单位)。
返回值
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
找不到 由 Tag 标识的数据。 |
此方法还可以返回错误值。 有关更多详细信息 ,请参阅返回值 。
注解
某些调试器会话具有可用的任意附加数据。 例如,创建转储文件时,还可以创建包含额外信息的附加转储信息文件。 此附加数据使用全局唯一标识符进行标记,只能通过 标记进行检索。
LPGUID 是指向 128 位唯一标识符的指针。 它在 Microsoft Windows SDK 头文件 guiddef.h 中定义。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | dbgeng.h (包括 Dbgeng.h) |