FwpmProviderContextGetByKey0 function (fwpmk.h)

The FwpmProviderContextGetByKey0 function retrieves a provider context.

Syntax

NTSTATUS FwpmProviderContextGetByKey0(
  [in] HANDLE                 engineHandle,
       const GUID             *key,
       FWPM_PROVIDER_CONTEXT0 **providerContext
);

Parameters

[in] engineHandle

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

key

Pointer to a GUID that uniquely identifies the provider context. This is a pointer to the same GUID that was specified when the application called FwpmProviderContextAdd0 for this object.

providerContext

The provider context information.

Return value

Remarks

The caller must free the returned object by a call to FwpmFreeMemory0.

The caller needs FWPM_ACTRL_READ access to the provider context. See Access Control for more information.

FwpmProviderContextGetByKey0 is a specific implementation of FwpmProviderContextGetByKey. See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information.

Requirements

See also

Here are all the links in the current document:

• FwpmEngineOpen0
• FwpmProviderContextAdd0
• FwpmFreeMemory0
• FWPM_ACTRL_READ
• FWPM_PROVIDER_CONTEXT0
• WFP Error Codes
• Access Control
• WFP Version-Independent Names and Targeting Specific Versions of Windows