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 所指定數據的位元組大小總計。

傳回值

傳回碼 描述
S_OK
 此方法成功。
E_NOINTERFACE
 找不到 Tag 所識別的數據。
 

這個方法也可以傳回錯誤值。 如需詳細資訊，請參閱 傳回值 。

備註

某些調試程式會話具有任意可用的其他數據。 例如，建立傾印檔案時，也可以建立包含額外資訊的其他傾印資訊檔案。 這個額外的數據會以全域唯一標識符標記，而且只能透過標記擷取。

LPGUID 是128位唯一標識碼的指標。 它定義於 Microsoft Windows SDK 頭檔 guiddef.h 中。

規格需求

需求 值
目標平台 桌面
標頭 dbgeng.h (包含 Dbgeng.h)

另請參閱

GetNextTagged

IDebugDataSpaces3

IDebugDataSpaces4