IDebugControl：：GetEventFilterText 方法 (dbgeng.h)

  • 發行項

GetEventFilterText 方法會針對特定篩選傳回事件的簡短描述。

語法

HRESULT GetEventFilterText(
  [in]            ULONG  Index,
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG TextSize
);

參數

[in] Index

指定將傳回其描述之事件篩選條件的索引。 只有特定篩選條件會附加描述; 索引 必須參考特定的篩選。

[out, optional] Buffer

接收特定篩選的描述。

[in] BufferSize

指定 Buffer 所指定緩衝區的大小，以字元為單位。 此大小包含 『\0』 終止字元的空間。

[out, optional] TextSize

接收事件描述的大小。 此大小包含 『\0』 終止字元的空間。 如果 TextSize 為 NULL，則不會傳回此資訊。

傳回值

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

傳回碼 描述
S_OK
 此方法成功。
E_NOINTERFACE
 索引 未參考特定篩選。 如果 Index 參考任意例外狀況篩選，就會發生這種情況。

備註

如需 事件篩選的詳細資訊，請參閱 事件篩選。

規格需求

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

另請參閱

GetSpecificFilterParameters

IDebugControl

IDebugControl2

IDebugControl3

sx、sxd、sxe、sxi、sxn (設定例外狀況)