Funzione FwpmFilterSubscribeChanges0 (fwpmu.h)

Articolo
03/05/2024

La funzione FwpmFilterSubscribeChanges0 viene usata per richiedere il recapito delle notifiche relative alle modifiche in un determinato filtro.

Sintassi

DWORD FwpmFilterSubscribeChanges0(
  [in]           HANDLE                          engineHandle,
  [in]           const FWPM_FILTER_SUBSCRIPTION0 *subscription,
  [in]           FWPM_FILTER_CHANGE_CALLBACK0    callback,
  [in, optional] void                            *context,
  [out]          HANDLE                          *changeHandle
);

Parametri

[in] engineHandle

Tipo: HANDLE

Handle per una sessione aperta al motore di filtro. Chiamare FwpmEngineOpen0 per aprire una sessione al motore di filtro.

[in] subscription

Tipo: FWPM_FILTER_SUBSCRIPTION0*

Notifiche da recapitare.

[in] callback

Tipo: FWPM_FILTER_CHANGE_CALLBACK0

Puntatore alla funzione che verrà richiamato quando una notifica è pronta per il recapito.

[in, optional] context

Tipo: void*

Puntatore di contesto facoltativo. Questo puntatore viene passato alla funzione callback insieme ai dettagli della modifica.

[out] changeHandle

Tipo: HANDLE*

Gestire la sottoscrizione appena creata.

Valore restituito

Tipo: DWORD

Codice/valore restituito	Descrizione
ERROR_SUCCESS 0	La sottoscrizione è stata creata correttamente.
*FWP_E_ codice di errore** 0x80320001: 0x80320039	Errore specifico di Windows Filtering Platform (WFP). Per informazioni dettagliate, vedere Codici di errore WFP .
*RPC_ codice di errore** 0x80010001: 0x80010122	Non è possibile comunicare con il motore firewall remoto o locale.

Commenti

I sottoscrittori non ricevono notifiche per le modifiche apportate con lo stesso handle di sessione usato per sottoscrivere. Questo è dovuto al fatto che i sottoscrittori devono vedere solo le modifiche apportate da altri perché sanno già quali modifiche sono state apportate.

Questa funzione non può essere chiamata dall'interno di una transazione. Avrà esito negativo con FWP_E_TXN_IN_PROGRESS. Per altre informazioni sulle transazioni, vedere Gestione oggetti .

Il chiamante deve FWPM_ACTRL_SUBSCRIBE l'accesso al contenitore del filtro e FWPM_ACTRL_READ l'accesso al filtro. Il sottoscrittore riceverà solo notifiche per i filtri a cui ha FWPM_ACTRL_READ accesso. Per altre informazioni, vedere Controllo di accesso.

FwpmFilterSubscribeChanges0 è un'implementazione specifica di FwpmFilterSubscribeChanges. Per altre informazioni , vedere Nomi Version-Independent WFP e Versioni specifiche di Windows .

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	fwpmu.h
Libreria	Fwpuclnt.lib
DLL	Fwpuclnt.dll

Vedi anche

FWPM_FILTER_CHANGE_CALLBACK0

FWPM_FILTER_SUBSCRIPTION0

FwpmFilterUnsubscribeChanges0

Condividi tramite