Funzione FwpmConnectionUnsubscribe0 (fwpmu.h)
La funzione FwpmConnectionUnsubscribe0 viene usata per annullare una sottoscrizione dell'evento di modifica dell'oggetto connessione e interrompere la ricezione delle notifiche.
Sintassi
DWORD FwpmConnectionUnsubscribe0(
[in] HANDLE engineHandle,
[in, 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, out] eventsHandle
Tipo: HANDLE
Gestire la notifica dell'evento sottoscritto. Questo è l'handle restituito dalla chiamata a FwpmConnectionSubscribe0.
Questo può essere NULL, in tal caso la funzione non avrà alcun effetto.
Valore restituito
Tipo: DWORD
| Codice/valore restituito | Descrizione |
|---|---|
|
La sottoscrizione è stata eliminata correttamente. |
|
Errore specifico di Windows Filtering Platform (WFP). Per informazioni dettagliate, vedere Codici di errore WFP . |
|
Non è possibile comunicare con il motore firewall remoto o locale. |
Commenti
Se il callback è attualmente richiamato, questa funzione non restituirà finché non viene completata. Pertanto, quando si chiama questa funzione, non è necessario contenere blocchi che il callback potrebbe anche provare ad acquisire il più possibile deadlock.
Non è necessario annullare la sottoscrizione prima di chiudere una sessione; tutte le sottoscrizioni vengono annullate automaticamente al termine della sessione di sottoscrizione.
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 .
Requisiti
| 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 |