Funzione FwpmProviderAdd0 (fwpmu.h)

Articolo
02/29/2024

La funzione FwpmProviderAdd0 aggiunge un nuovo provider al sistema.

Sintassi

DWORD FwpmProviderAdd0(
  [in]           HANDLE               engineHandle,
  [in]           const FWPM_PROVIDER0 *provider,
  [in, optional] PSECURITY_DESCRIPTOR sd
);

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] provider

Tipo: FWPM_PROVIDER0*

Oggetto provider da aggiungere.

[in, optional] sd

Tipo: PSECURITY_DESCRIPTOR

Informazioni di sicurezza per l'oggetto provider.

Valore restituito

Tipo: DWORD

Codice/valore restituito	Descrizione
ERROR_SUCCESS 0	Il provider è stato aggiunto correttamente.
*FWP_E_ codice di errore** 0x80320001: 0x80320039	Errore specifico di Windows Filtering Platform (WFP). Per informazioni dettagliate, vedere Codici di errore WFP .
*RPC_ codice di errore** 0x80010001: 0x80010122	Non è possibile comunicare con il motore firewall remoto o locale.

Commenti

Se il chiamante fornisce un descrittore di sicurezza Null, il sistema assegna un descrittore di sicurezza predefinito.

Gli oggetti di avvio vengono aggiunti al motore di filtro di base (BFE) all'avvio del driver TCP/IP e vengono rimossi al termine dell'inizializzazione BFE. Gli oggetti persistenti vengono aggiunti all'avvio del BFE. Se un provider di criteri ha un criterio persistente che non deve essere applicato se il servizio associato è disabilitato, il chiamante può specificare un nome di servizio facoltativo nella struttura FWPM_PROVIDER0 . Questo servizio possiede quindi l'oggetto criteri persistente. All'inizio, il BFE aggiunge solo i tipi seguenti di oggetti persistenti al sistema.

L'oggetto non è associato a un provider.
L'oggetto ha un provider associato che non specifica un nome del servizio.
L'oggetto ha un provider associato e un servizio associato impostato su avvio automatico.

Questa funzione non può essere chiamata dall'interno di una transazione di sola lettura. Avrà esito negativo con FWP_E_INCOMPATIBLE_TXN. Per altre informazioni sulle transazioni, vedere Gestione oggetti .

Il chiamante deve FWPM_ACTRL_ADD l'accesso al contenitore del provider. Per altre informazioni, vedere Controllo di accesso.

FwpmProviderAdd0 è un'implementazione specifica di FwpmProviderAdd. Per altre informazioni , vedere Nomi Version-Independent WFP e Versioni specifiche di Windows .

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

Vedi anche

FWPM_PROVIDER0

Condividi tramite