Funzione FwpmCalloutSubscribeChanges0 (fwpmu.h)

Articolo
08/23/2023

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

Sintassi

DWORD FwpmCalloutSubscribeChanges0(
  [in]           HANDLE                           engineHandle,
  [in]           const FWPM_CALLOUT_SUBSCRIPTION0 *subscription,
  [in]           FWPM_CALLOUT_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_CALLOUT_SUBSCRIPTION0*

Notifiche che verranno recapitate.

[in] callback

Tipo: FWPM_CALLOUT_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 callout e FWPM_ACTRL_READ l'accesso al callout. Il sottoscrittore riceverà solo notifiche per i callout a cui ha FWPM_ACTRL_READ accesso. Per altre informazioni, vedere Controllo di accesso.

FwpmCalloutSubscribeChanges0 è un'implementazione specifica di FwpmCalloutSubscribeChanges . 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_CALLOUT_CHANGE_CALLBACK0

FWPM_CALLOUT_SUBSCRIPTION0

FwpmCalloutUnsubscribeChanges0

Condividi tramite