Funzione FwpmConnectionSubscribe0 (fwpmu.h)
La funzione FwpmConnectionSubscribe0 viene utilizzata per richiedere il recapito delle notifiche relative alle modifiche apportate a un oggetto connessione.
Sintassi
DWORD FwpmConnectionSubscribe0(
[in] HANDLE engineHandle,
[in] const FWPM_CONNECTION_SUBSCRIPTION0 *subscription,
[in] FWPM_CONNECTION_CALLBACK0 callback,
[in, optional] void *context,
[out] HANDLE *eventsHandle
);
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_CONNECTION_SUBSCRIPTION0*
Notifiche che verranno recapitate.
[in] callback
Tipo: FWPM_CONNECTION_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 dell'evento.
[out] eventsHandle
Tipo: HANDLE*
Gestire la sottoscrizione appena creata.
Valore restituito
Tipo: DWORD
| Codice/valore restituito | Descrizione |
|---|---|
|
La sottoscrizione è stata creata correttamente. |
|
Errore specifico di Windows Filtering Platform (WFP). Per informazioni dettagliate, vedere Codici di errore del WFP . |
|
Errore di comunicazione con il motore firewall remoto o locale. |
Commenti
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 dell'oggetto connessione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 [solo app desktop] |
| Server minimo supportato | Windows Server 2012 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | fwpmu.h |
| Libreria | Fwpuclnt.lib |
| DLL | Fwpuclnt.dll |