Funzione FwpmProviderContextGetById0 (fwpmu.h)
La funzione FwpmProviderContextGetById0 recupera un contesto del provider.
NotaFwpmProviderContextGetById0 è l'implementazione specifica di FwpmProviderContextGetById usato in Windows Vista. Per altre informazioni , vedere Nomi Version-Independent WFP e Versioni specifiche di Windows . Per Windows 7, FwpmProviderContextGetById1 è disponibile. Per Windows 8, è disponibile FwpmProviderContextGetById2.
Sintassi
DWORD FwpmProviderContextGetById0(
[in] HANDLE engineHandle,
[in] UINT64 id,
[out] FWPM_PROVIDER_CONTEXT0 **providerContext
);
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: UINT64
Identificatore di runtime per l'oggetto desiderato. Questo deve essere l'identificatore di runtime ricevuto dal sistema quando l'applicazione denominata FwpmProviderContextAdd0 per questo oggetto.
[out] providerContext
Tipo: FWPM_PROVIDER_CONTEXT0**
Informazioni sul contesto del provider.
Valore restituito
Tipo: DWORD
| Codice/valore restituito | Descrizione |
|---|---|
|
Il contesto del provider è 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 contesto del provider. Per altre informazioni, vedere Controllo di accesso.
Requisiti
| Requisito | Valore |
|---|---|
| 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 |