Funzione FwpmCalloutGetById0 (fwpmk.h)
La funzione FwpmCalloutGetById0 recupera un callout dal motore di filtro usando l'identificatore di runtime per il callout.
Sintassi
NTSTATUS FwpmCalloutGetById0(
[in] HANDLE engineHandle,
[in] UINT32 id,
[out] FWPM_CALLOUT0 **callout
);
Parametri
[in] engineHandle
Handle per una sessione aperta al motore di filtro. Chiamare funzione fwpmEngineOpen0 per aprire una sessione al motore di filtro.
[in] id
Identificatore di runtime per il callout da recuperare dal motore di filtro. Deve essere l'identificatore di runtime restituito quando il driver del callout ha chiamato la funzione FwpmCalloutAdd0 per aggiungere il callout al motore di filtro.
[out] callout
Informazioni sullo stato associato al callout specificato dal parametro ID.
Valore restituito
La funzione fwpmCalloutCalloutGetId0 restituisce uno dei codici NTSTATUS seguenti.
| Codice/valore restituito | Descrizione |
|---|---|
|
ERROR_SUCCESS 0 |
Il callout è stato recuperato correttamente. |
|
FWP_E_* codice di errore 0x80320001: 0x80320039 |
Errore specifico di Windows Filtering Platform (WFP). Per informazioni dettagliate, vedere Codici di errore DEL WFP. |
|
RPC_* codice di errore 0x80010001: 0x80010122 |
Errore di comunicazione con il motore firewall remoto o locale. |
| Altri codici NTSTATUS | Si è verificato un errore. |
Osservazioni
Il chiamante deve liberare l'oggetto restituito da una chiamata a FwpmFreeMemory0.
Il chiamante deve FWPM_ACTRL_READ l'accesso al callout. Per altre informazioni, vedere di controllo di accesso.
FwpmCalloutGetById0 è un'implementazione specifica di FwpmCalloutGetById. Per altre informazioni, vedere nomi Version-Independent WFP e selezione di versioni specifiche di Windows.
Fabbisogno
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows Vista. |
| Piattaforma di destinazione | Universale |
| intestazione | fwpmk.h |
| Biblioteca | fwpkclnt.lib |
| IRQL | <= PASSIVE_LEVEL |