Condividi tramite

Funzione FwpmProviderContextAdd3 (fwpmk.h)

  • Articolo

La funzione fwpmProviderContextAdd3 aggiunge un nuovo contesto del provider al sistema.

Sintassi

NTSTATUS FwpmProviderContextAdd3(
  [in]            HANDLE                       engineHandle,
  [in]            const FWPM_PROVIDER_CONTEXT3 *providerContext,
  [in, optional]  PSECURITY_DESCRIPTOR         sd,
  [out, optional] UINT64                       *id
);

Parametri

[in] engineHandle

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

[in] providerContext

Oggetto contesto del provider da aggiungere.

[in, optional] sd

Informazioni di sicurezza associate all'oggetto contesto del provider.

[out, optional] id

Puntatore a una variabile che riceve un identificatore di runtime per questo contesto del provider.

Valore restituito

Codice/valore restituito Descrizione
ERROR_SUCCESS
0		 Il contesto del provider è stato aggiunto correttamente.
ERROR_NOT_SUPPORTED
0x32		 Il FWPM_IPSEC_IKE_MM_CONTEXTe il metodo di autenticazione IKEEXT_IPV6_CGA nell'authenticationMethods matrice, ma l'indirizzo CGA (Cryptographically Generated Address) non è abilitato nel Registro di sistema.
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

Alcuni campi nella struttura FWPM_PROVIDER_CONTEXT3 vengono assegnati dal sistema, non dal chiamante e vengono ignorati nella chiamata a FwpmProviderContextAdd3.

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

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 contesto del provider e FWPM_ACTRL_ADD_LINK l'accesso al provider (se presente). Per altre informazioni, vedere di controllo di accesso.

FwpmProviderContextAdd0 è un'implementazione specifica di FwpmProviderContextAdd. 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