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

接收数据。 如果 缓冲区NULL,则不会返回数据。

[in] BufferSize

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

[out, optional] TotalSize

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

返回值

返回代码 描述
S_OK
该方法成功。
E_NOINTERFACE
找不到 标记 标识的数据。
 

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

言论

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

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

要求

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

另请参阅

GetNextTagged

IDebugDataSpaces3

IDebugDataSpaces4