Funzione FwpmSystemPortsUnsubscribe0 (fwpmu.h)
La funzione FwpmSystemPortsUnsubscribe0 viene usata per annullare una sottoscrizione della porta di sistema e interrompere la ricezione delle notifiche.
Sintassi
DWORD FwpmSystemPortsUnsubscribe0(
[in, optional] HANDLE engineHandle,
[in, out] HANDLE sysPortsHandle
);
Parametri
[in, optional] engineHandle
Tipo: HANDLE
Handle per una sessione aperta al motore di filtro. Chiamare FwpmEngineOpen0 per aprire una sessione al motore di filtro.
[in, out] sysPortsHandle
Tipo: HANDLE
Handle della notifica della porta di sistema sottoscritta. Handle restituito dalla chiamata a FwpmSystemPortsSubscribe0.
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 del WFP . |
|
Errore di comunicazione con il motore firewall remoto o locale. |
Commenti
L'annullamento della sottoscrizione con un handle di oggetto non valido comporterà un valore restituito di ERROR_SUCCESS, ma la sottoscrizione effettiva verrà mantenuta fino a quando l'API di annullamento della sottoscrizione non viene chiamata con parametri validi.
Se il callback è attualmente richiamato, questa funzione non verrà restituita fino al completamento. Pertanto, quando si chiama questa funzione, non è necessario contenere blocchi che il callback potrebbe anche tentare di 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.
FwpmSystemPortsUnsubscribe0 è un'implementazione specifica di FwpmSystemPortsUnsubscribe. 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
| Client minimo supportato | Windows 7 [solo app desktop] |
| Server minimo supportato | Windows Server 2008 R2 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | fwpmu.h |
| Libreria | Fwpuclnt.lib |
| DLL | Fwpuclnt.dll |