Condividi tramite

Funzione FwpmDynamicKeywordSubscribe0 (fwpmu.h)

  • Articolo

Richiede il recapito delle notifiche relative alle modifiche apportate a particolari oggetti indirizzo di parole chiave dinamica (FW_DYNAMIC_KEYWORD_ADDRESS0). In base al flag passato, le notifiche possono essere generate solo per un subset degli indirizzi.

Per altre info ed esempi di codice, vedi Parole chiave dinamiche del firewall.

Sintassi

DWORD FwpmDynamicKeywordSubscribe0(
  DWORD                          flags,
  FWPM_DYNAMIC_KEYWORD_CALLBACK0 callback,
  void                           *context,
  HANDLE                         *subscriptionHandle
);

Parametri

flags

Tipo: _In_ DWORD

I flag seguenti sono definiti in fwpmu.h.

FWPM_NOTIFY_ADDRESSES_AUTO_RESOLVE indica che le notifiche verranno recapitate solo per gli oggetti con il flag FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE impostato.

FWPM_NOTIFY_ADDRESSES_NON_AUTO_RESOLVE indica che le notifiche verranno recapitate solo per gli oggetti che non dispongono del flag FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE impostato.

FWPM_NOTIFY_ADDRESSES_AUTO_RESOLVE indica che le notifiche verranno recapitate per tutti gli oggetti indirizzo di parole chiave dinamici.

callback

Tipo: _In_ FWPM_DYNAMIC_KEYWORD_CALLBACK0

Puntatore a una funzione di callback implementata, che verrà richiamata quando una notifica è pronta per il recapito.

context

Tipo: _In_opt_ void*

Un puntatore di contesto facoltativo. Questo puntatore viene passato alla funzione di callback.

subscriptionHandle

Tipo: _Out_ HANDLE*

Indirizzo di un handle, popolato con un handle per la sottoscrizione appena creata.

Valore restituito

Tipo: DWORD

Se la funzione ha esito positivo, restituisce ERROR_SUCCESS. In caso contrario, restituisce uno dei valori seguenti.

Valore restituito Descrizione
ERROR_INVALID_PARAMETER Il valore dei flag è zero.

Commenti

Le notifiche per gli indirizzi delle parole chiave dinamiche autoResolve vengono recapitate quando un oggetto viene aggiunto o eliminato.

Le notifiche per gli indirizzi di parole chiave dinamici non AutoResolve vengono recapitate quando un oggetto viene aggiunto, eliminato o aggiornato.

Nessun dato viene fornito alla funzione di callback. È possibile usare l'API di enumerazione se sono necessarie informazioni sulle modifiche apportate al sistema.

L'utente è responsabile della chiusura dell'handle quando non è più necessaria la sottoscrizione. A tale scopo, è necessario chiamare la funzione FwpmDynamicKeywordUnsubscribe0 .

L'implementazione di FWPM_DYNAMIC_KEYWORD_CALLBACK0 deve reagire rapidamente alle modifiche apportate agli oggetti di indirizzi di parole chiave dinamiche, perché è pianificata in un thread ThreadPool e potrebbe influire su altre operazioni di attesa.

Requisiti

Requisito Valore
Client minimo supportato Windows 10 Build 20348
Server minimo supportato Windows 10 Build 20348
Piattaforma di destinazione Windows
Intestazione fwpmu.h
Libreria Fwpuclnt.lib
DLL Fwpuclnt.dll

Vedi anche