EVT_SUBSCRIBE_CALLBACK winevt.h) (回呼函式

如果您呼叫 EvtSubscribe 函式來接收符合查詢的事件，請實作此回呼。 當引發符合查詢準則的事件時，服務會呼叫您的回呼。

語法

EVT_SUBSCRIBE_CALLBACK EvtSubscribeCallback;

DWORD EvtSubscribeCallback(
  EVT_SUBSCRIBE_NOTIFY_ACTION Action,
  PVOID UserContext,
  EVT_HANDLE Event
)
{...}

參數

Action

判斷 Event 參數是否包含事件或錯誤碼。 如需可能的通知動作值，請參閱 EVT_SUBSCRIBE_NOTIFY_ACTION 列舉。

UserContext

訂閱者傳遞至 EvtSubscribe 函式的內容。

Event

事件的句柄。 事件句柄只有在回呼函式的持續時間才有效。 您可以使用此句柄搭配任何採用事件句柄的事件記錄函式 (例如 EvtRender 或 EvtFormatMessage) 。

請勿呼叫 EvtClose 關閉此句柄;當回呼傳回時，服務會關閉句柄。

如果 Action 參數是 EvtSubscribeActionError，請將 Event 轉換為 DWORD 以存取 Win32 錯誤碼。

傳回值

服務會忽略您傳回的傳回碼。

備註

此回呼會封鎖其他事件傳遞至回呼，因此請儘可能縮短實作。

如果服務在設定訂用帳戶時發生錯誤，您的回呼將不會收到發生錯誤的任何通知。

如果 EvtSubscribe 的 Flags 參數包含 EvtSubscribeStrict，您的回呼會在事件記錄遺失時收到通知。 在此情況下， 事件 的值將會ERROR_EVT_QUERY_RESULT_STALE。

若要取消訂閱，您必須關閉 EvtSubscribe 函式傳回的訂用帳戶句柄。

範例

如需實作 EVT_SUBSCRIBE_CALLBACK 回呼函式的範例，請參閱 訂閱事件。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	winevt.h

另請參閱

EvtSubscribe