共用方式為

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

指定緩衝區的大小，以位元組為單位，Buffer。 這是將傳回的最大位元元組數目。

[out, optional] TotalSize

接收由 Tag所指定數據的總位元組大小。

傳回值

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

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

言論

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

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

要求

要求 價值
目標平臺 桌面
標頭 dbgeng.h （include Dbgeng.h）

另請參閱

GetNextTagged

IDebugDataSpaces3

IDebugDataSpaces4