SetTraceCallback 函式 (evntrace.h)
重要
請勿使用此函式;後續版本可能無法使用。 相反地，篩選 EventRecordCallback 函式中的事件追蹤類別。
SetTraceCallback 函式會指定 EventCallback 函式來處理指定事件追蹤類別的事件。
語法
ULONG WMIAPI SetTraceCallback(
[in] LPCGUID pGuid,
[in] PEVENT_CALLBACK EventCallback
);
參數
[in] pGuid
您要接收事件之事件追蹤類別的類別 GUID 指標。 如需核心提供者類別 GUID 的清單，請參閱 NT 核心記錄器常數。
[in] EventCallback
EventCallback 函式的指標，用來處理屬於事件追蹤類別的事件。
傳回值
如果函式成功，傳回值會ERROR_SUCCESS。
如果函式失敗，傳回值就是其中一個 系統錯誤碼。 以下是一些常見的錯誤及其原因。
ERROR_INVALID_PARAMETER
以下其中一項為正確：
- pGuid 為 NULL。
- EventCallback 為 NULL。
備註
取用者會呼叫此函式。
您只能為事件追蹤類別指定一個回呼函式。 如果您為事件追蹤類別指定多個回呼函式，則最後一個回呼函式會收到該事件追蹤類別的事件。
若要停止回呼函式接收事件追蹤類別的事件，請呼叫 RemoveTraceCallback 函式。 當您關閉追蹤時，回呼會自動停止接收回呼。
您可以使用此函式來接收使用其中一個 TraceEvent 函式所撰寫的事件。 您無法使用此函式從使用其中一個 EventWrite 函式來記錄事件的提供者取用事件。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | evntrace.h |
| 程式庫 | Windows 8.1 和 Windows Server 2012 R2 上的 Sechost.lib;Windows 8、Windows Server 2012、Windows 7、Windows Server 2008 R2、Windows Server 2008、Windows Vista 和 Windows XP 上的 Advapi32.lib |
| Dll | Sechost.dll Windows 8.1 和 Windows Server 2012 R2;Windows 8、Windows Server 2012、Windows 7、Windows Server 2008 R2、Windows Server 2008、Windows Vista 和 Windows XP 上的 Advapi32.dll |