FwpsCompleteClassify0 function (fwpsk.h)

Article
02/22/2024

A callout driver calls FwpsCompleteClassify0 to asynchronously complete a pended classify request. The callout driver's classifyFn function must have previously called FwpsPendClassify0 to pend the classify request.

Note

FwpsCompleteClassify0 is a specific version of FwpsCompleteClassify. See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information.

Syntax

void FwpsCompleteClassify0(
  [in]           UINT64                   classifyHandle,
  [in]           UINT32                   flags,
  [in, optional] const FWPS_CLASSIFY_OUT0 *classifyOut
);

Parameters

[in] classifyHandle

The classification handle that identifies the callout driver's processing at the current layer. This handle is obtained by calling FwpsAcquireClassifyHandle0.

[in] flags

This parameter is reserved for future use. Set to zero.

[in, optional] classifyOut

A pointer to a deep copy of the FWPS_CLASSIFY_OUT0 structure that was originally passed to the classifyFn call when the classification was pended. When classifying asynchronously, the members of this structure can be set the same way as they would be in the callout driver's classifyFn function when classifying inline.

If this parameter is used, the classification is taken as the callout driver's final decision. If set to NULL, the indication will be reauthorized.

Return value

None

Remarks

FwpsCompleteClassify0 must be called after a callout driver has called FwpsPendClassify0 to remove the classification from its pended state.

After calling this function, FwpsReleaseClassifyHandle0 must be called to free the system resources associated with the classification handle.

Requirements

Requirement	Value
Minimum supported client	Available starting with Windows 7.
Target Platform	Universal
Header	fwpsk.h (include Fwpsk.h)
Library	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL