Funzione FwpmFilterGetByKey0 (fwpmu.h)
La funzione FwpmFilterGetByKey0 recupera un oggetto filtro.
Sintassi
DWORD FwpmFilterGetByKey0(
[in] HANDLE engineHandle,
[in] const GUID *key,
[out] FWPM_FILTER0 **filter
);
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] key
Tipo: GUID const*
Identificatore univoco del filtro. Questo GUID è stato specificato nel membro filterKey del parametro di filtro quando l'applicazione denominata FwpmFilterAdd0 per questo oggetto.
[out] filter
Tipo: FWPM_FILTER0**
Informazioni sui filtri.
Valore restituito
Tipo: DWORD
| Codice/valore restituito | Descrizione |
|---|---|
|
Il filtro è stato recuperato 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
Il chiamante deve liberare l'oggetto restituito da una chiamata a FwpmFreeMemory0.
Il chiamante deve FWPM_ACTRL_READ l'accesso al filtro. Per altre informazioni, vedere Controllo di accesso.
FwpmFilterGetByKey0 è un'implementazione specifica di FwpmFilterGetByKey. Per altre informazioni , vedere Nomi Version-Independent WFP e Versioni specifiche di Windows .
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 |