EVT_SUBSCRIBE_CALLBACK funzione di callback (winevt.h)
Implementare questo callback se si chiama la funzione EvtSubscribe per ricevere eventi corrispondenti alla query. Il servizio chiama il callback quando vengono generati eventi che corrispondono ai criteri di query.
Sintassi
EVT_SUBSCRIBE_CALLBACK EvtSubscribeCallback;
DWORD EvtSubscribeCallback(
EVT_SUBSCRIBE_NOTIFY_ACTION Action,
PVOID UserContext,
EVT_HANDLE Event
)
{...}
Parametri
Action
Determina se il parametro Event contiene un evento o un codice di errore. Per eventuali valori di azione di notifica, vedere l'enumerazione EVT_SUBSCRIBE_NOTIFY_ACTION .
UserContext
Contesto passato dal sottoscrittore alla funzione EvtSubscribe .
Event
Handle per l'evento. L'handle eventi è valido solo per la durata della funzione di callback. È possibile usare questo handle con qualsiasi funzione di log eventi che accetta un handle di eventi, ad esempio EvtRender o EvtFormatMessage.
Non chiamare EvtClose per chiudere questo handle; il servizio chiuderà l'handle quando il callback restituisce.
Se il parametro Action è EvtSubscribeActionError, eseguire il cast dell'evento in un DWORD per accedere al codice di errore Win32.
Valore restituito
Il servizio ignora il codice restituito restituito.
Commenti
Questo callback impedisce il recapito di altri eventi al callback, in modo da mantenere l'implementazione il più breve possibile.
Se il servizio riscontra un errore durante la configurazione della sottoscrizione, il callback non riceverà alcuna notifica che si è verificato un errore.
Se il parametro Flags di EvtSubscribe include EvtSubscribeStrict , il callback riceverà la notifica quando mancano i record eventi. In questo caso, il valore dell'evento sarà ERROR_EVT_QUERY_RESULT_STALE.
Per annullare la sottoscrizione, è necessario chiudere l'handle di sottoscrizione restituito dalla funzione EvtSubscribe .
Esempio
Per un esempio che implementa EVT_SUBSCRIBE_CALLBACK funzione di callback, vedere Sottoscrizione agli eventi.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winevt.h |