Funzione FwpmCalloutDeleteById0 (fwpmu.h)
La funzione FwpmCalloutDeleteById0 rimuove un oggetto callout dal sistema.
Sintassi
DWORD FwpmCalloutDeleteById0(
[in] HANDLE engineHandle,
[in] UINT32 id
);
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] id
Tipo: UINT32
Identificatore di runtime per il callout da rimuovere dal sistema. Questo identificatore è stato ricevuto dal sistema quando l'applicazione ha chiamato FwpmCalloutAdd0 per questo oggetto.
Valore restituito
Tipo: DWORD
| Codice/valore restituito | Descrizione |
|---|---|
|
Il callout è stato eliminato 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
I callout di un'applicazione non possono essere rimossi dal sistema, purché nel sistema siano presenti filtri che specificano i callout per un'azione.
Questa funzione non può essere chiamata dall'interno di una transazione di sola lettura. L'errore avrà esito negativo con FWP_E_INCOMPATIBLE_TXN. Per altre informazioni sulle transazioni, vedere Gestione oggetti.
Questa funzione può essere chiamata all'interno di una sessione dinamica se l'oggetto corrispondente è stato aggiunto durante la stessa sessione. Se questa funzione viene chiamata per un oggetto aggiunto durante una sessione dinamica diversa, l'operazione avrà esito negativo con FWP_E_WRONG_SESSION. Se questa funzione viene chiamata per un oggetto che non è stato aggiunto durante una sessione dinamica, avrà esito negativo con FWP_E_DYNAMIC_SESSION_IN_PROGRESS.
Il chiamante necessita dell'accesso DELETE al callout. Per altre informazioni, vedere Controllo di accesso.
FwpmCalloutDeleteById0 è un'implementazione specifica di FwpmCalloutDeleteById. 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 Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | fwpmu.h |
| Libreria | Fwpuclnt.lib |
| DLL | Fwpuclnt.dll |