IDebugDataSpaces3::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

接收数据。 如果 BufferNULL,则不返回数据。

[in] BufferSize

指定缓冲区 缓冲区的大小(以字节为单位)。 这是将返回的最大字节数。

[out, optional] TotalSize

接收 Tag 指定的数据的总大小(以字节为单位)。

返回值

返回代码 说明
S_OK
方法成功。
E_NOINTERFACE
找不到 由 Tag 标识的数据。
 

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

注解

某些调试器会话具有可用的任意附加数据。 例如,创建转储文件时,还可以创建包含额外信息的附加转储信息文件。 此附加数据使用全局唯一标识符进行标记,只能通过 标记进行检索。

LPGUID 是指向 128 位唯一标识符的指针。 它在 Microsoft Windows SDK 头文件 guiddef.h 中定义。

要求

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

另请参阅

GetNextTagged

IDebugDataSpaces3

IDebugDataSpaces4