Skip to content

Latest commit

 

History

History
155 lines (124 loc) · 4.81 KB

nf-fwpmu-fwpmprovidercontextadd1.md

File metadata and controls

155 lines (124 loc) · 4.81 KB
Raw
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:fwpmu.FwpmProviderContextAdd1
FwpmProviderContextAdd1 function (fwpmu.h)
Adds a new provider context to the system. (FwpmProviderContextAdd1)
FwpmProviderContextAdd1
FwpmProviderContextAdd1 function [Filtering]
fwp.fwpmprovidercontextadd1_func
fwpmu/FwpmProviderContextAdd1
fwp\fwpmprovidercontextadd1_func.htm
fwp
2a840f23-96e4-4b3d-b92e-53b3d10ab2bb
12/05/2018
FwpmProviderContextAdd1, FwpmProviderContextAdd1 function [Filtering], fwp.fwpmprovidercontextadd1_func, fwpmu/FwpmProviderContextAdd1
fwpmu.h
Windows
Windows 7 [desktop apps only]
Windows Server 2008 R2 [desktop apps only]
Fwpuclnt.lib
Fwpuclnt.dll
Windows
19H1
FwpmProviderContextAdd1
fwpmu/FwpmProviderContextAdd1
c++
APIRef
kbSyntax
DllExport
Fwpuclnt.dll
FwpmProviderContextAdd1

FwpmProviderContextAdd1 function

-description

The FwpmProviderContextAdd1 function adds a new provider context to the system.

Note  FwpmProviderContextAdd1 is the specific implementation of FwpmProviderContextAdd used in Windows 7. See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information. For Windows 8, FwpmProviderContextAdd2 is available. For Windows Vista, FwpmProviderContextAdd0 is available.

 

-parameters

-param engineHandle [in]

Type: HANDLE

Handle for an open session to the filter engine. Call FwpmEngineOpen0 to open a session to the filter engine.

-param providerContext [in]

Type: FWPM_PROVIDER_CONTEXT1*

The provider context object to be added.

-param sd [in, optional]

Type: PSECURITY_DESCRIPTOR

Security information associated with the provider context object.

-param id [out, optional]

Type: UINT64*

Pointer to a variable that receives a runtime identifier for this provider context.

-returns

Type: DWORD

Return code/value Description
ERROR_SUCCESS
0
 The provider context was successfully added.
ERROR_NOT_SUPPORTED
0x32
 The [IKEEXT_IPV6_CGA](/windows/desktop/api/iketypes/ne-iketypes-ikeext_authentication_method_type) authentication method in the authenticationMethods array, but cryptographically generated address (CGA) is not enabled in the registry.
FWP_E_* error code
0x80320001—0x80320039
 A Windows Filtering Platform (WFP) specific error. See WFP Error Codes for details.
RPC_* error code
0x80010001—0x80010122
 Failure to communicate with the remote or local firewall engine.

-remarks

Some fields in the FWPM_PROVIDER_CONTEXT1 structure are assigned by the system, not the caller, and are ignored in the call to FwpmProviderContextAdd1.

If the caller supplies a NULL security descriptor, the system will assign a default security descriptor.

This function cannot be called from within a read-only transaction. It will fail with FWP_E_INCOMPATIBLE_TXN. See Object Management for more information about transactions.

The caller needs FWPM_ACTRL_ADD access to the provider context's container and FWPM_ACTRL_ADD_LINK access to the provider (if any). See Access Control for more information.

-see-also

FWPM_PROVIDER_CONTEXT1