Funzione FwpmProviderContextAdd0 (fwpmu.h)

Articolo
08/23/2023

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

NotaFwpmProviderContextAdd0 è l'implementazione specifica di FwpmProviderContextAdd usato in Windows Vista. Per altre informazioni , vedere Nomi Version-Independent WFP e Versioni specifiche di Windows . Per Windows 7, FwpmProviderContextAdd1 è disponibile. Per Windows 8, FwpmProviderContextAdd2 è disponibile.

Sintassi

DWORD FwpmProviderContextAdd0(
  [in]            HANDLE                       engineHandle,
  [in]            const FWPM_PROVIDER_CONTEXT0 *providerContext,
  [in, optional]  PSECURITY_DESCRIPTOR         sd,
  [out, optional] UINT64                       *id
);

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

Tipo: FWPM_PROVIDER_CONTEXT0*

Oggetto contesto del provider da aggiungere.

[in, optional] sd

Tipo: PSECURITY_DESCRIPTOR

Informazioni di sicurezza associate all'oggetto contesto del provider.

[out, optional] id

Tipo: UINT64*

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

Valore restituito

Tipo: DWORD

Codice/valore restituito	Descrizione
ERROR_SUCCESS 0	Il contesto del provider è stato aggiunto correttamente.
ERROR_NOT_SUPPORTED 0x32	Il metodo di autenticazione [FWPM_IPSEC_IKE_MM_CONTEXT](/windows/desktop/api/fwpmtypes/ne-fwpmtypes-fwpm_provider_context_type)e il metodo di autenticazione [IKEEXT_IPV6_CGA](/windows/desktop/api/iketypes/ne-iketypes-ikeext_authentication_method_type) nella matrice authenticationMethods , ma l'indirizzo generato in modo crittografico (CGA) 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	Non è possibile comunicare con il motore firewall remoto o locale.

Commenti

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

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

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 contesto del provider e FWPM_ACTRL_ADD_LINK l'accesso al provider (se presente). 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

Vedi anche

FWPM_PROVIDER_CONTEXT0

Condividi tramite