Condividi tramite

Funzione FwpmProviderAdd0 (fwpmk.h)

  • Articolo

La funzione FwpmProviderAdd0 aggiunge un nuovo provider al sistema.

Sintassi

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

Parametri

[in] engineHandle

Handle per una sessione aperta al motore di filtro. Chiamare FwpmEngineOpen0 per aprire una sessione al motore di filtro.

[in] provider

Oggetto provider da aggiungere.

[in, optional] sd

Informazioni di sicurezza per l'oggetto provider.

Valore restituito

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		 Errore di comunicazione con il motore firewall remoto o locale.
Altri codici NTSTATUS Si è verificato un errore.

Osservazioni

Se il chiamante fornisce un descrittore di sicurezza Null, il sistema assegnerà 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 della BFE. Se un provider di criteri dispone di un criterio permanente 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 è quindi proprietario dell'oggetto criteri persistente. All'inizio, la BFE aggiunge solo i tipi seguenti di oggetti persistenti al sistema.

  • L'oggetto non è associato a un provider.
  • L'oggetto dispone di un provider associato che non specifica un nome di servizio.
  • L'oggetto ha un provider associato e un servizio associato impostato sull'avvio automatico.

Questa funzione non può essere chiamata dall'interno di una transazione di sola lettura, ma ha 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 di controllo di accesso.

FwpmProviderAdd0 è un'implementazione specifica di FwpmProviderAdd. 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
libreria fwpkclnt.lib
IRQL <= PASSIVE_LEVEL

Vedere anche