Funzione FwpmProviderContextAdd1 (fwpmu.h)

Articolo
02/26/2024

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

NotaFwpmProviderContextAdd1 è l'implementazione specifica di FwpmProviderContextAdd usata in Windows 7. Per altre informazioni, vedere Wfp Version-Independent Names and Targeting Specific Versions of Windows .See WFP Version-Independent Names and Targeting Specific Versions of Windows.See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information. Per Windows 8, è disponibile FwpmProviderContextAdd2. Per Windows Vista, fwpmProviderContextAdd0 è disponibile.

Sintassi

DWORD FwpmProviderContextAdd1(
  [in]            HANDLE                       engineHandle,
  [in]            const FWPM_PROVIDER_CONTEXT1 *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_CONTEXT1*

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 [IKEEXT_IPV6_CGA](/windows/desktop/api/iketypes/ne-iketypes-ikeext_authentication_method_type) nella matrice authenticationMethods , ma l'indirizzo generato da crittografia (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 del WFP .
*RPC_ codice di errore** 0x80010001: 0x80010122	Errore di comunicazione con il motore firewall remoto o locale.

Commenti

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

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

Questa funzione non può essere chiamata dall'interno di una transazione di sola lettura. L'errore 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 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	fwpmu.h
Libreria	Fwpuclnt.lib
DLL	Fwpuclnt.dll

Vedi anche

FWPM_PROVIDER_CONTEXT1

Condividi tramite