Funzione FwpmProviderSubscribeChanges0 (fwpmu.h)

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

Sintassi

DWORD FwpmProviderSubscribeChanges0(
  [in]           HANDLE                            engineHandle,
  [in, optional] const FWPM_PROVIDER_SUBSCRIPTION0 *subscription,
  [in]           FWPM_PROVIDER_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, optional] subscription

Tipo: FWPM_PROVIDER_SUBSCRIPTION0*

Notifiche da recapitare.

[in] callback

Tipo: FWPM_PROVIDER_CHANGE_CALLBACK0

Puntatore a 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 di callback insieme ai dettagli della modifica.

[out] changeHandle

Tipo: HANDLE*

Gestire la sottoscrizione appena creata.

Valore restituito

Tipo: DWORD

Commenti

I Sottoscrittori non ricevono notifiche per le modifiche apportate con lo stesso handle di sessione usato per sottoscrivere. Ciò è dovuto al fatto che i sottoscrittori devono visualizzare solo le modifiche apportate da altri utenti, perché già conoscono le modifiche 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 provider e FWPM_ACTRL_READ l'accesso al provider. Il sottoscrittore riceverà notifiche solo per i provider a cui ha accesso FWPM_ACTRL_READ . Per altre informazioni, vedere Controllo di accesso.

FwpmProviderSubscribeChanges0 è un'implementazione specifica di FwpmProviderSubscribeChanges. Per altre informazioni, vedere Wfp Version-Independent Names and Targeting Specific Versions of Windows .See WFP Version-Independent Names and Targeting Specific Versions of Windows.See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information.

Requisiti

Vedi anche

FWPM_PROVIDER_CHANGE_CALLBACK0

FWPM_PROVIDER_SUBSCRIPTION0