Expand Minimize

FwpsAcquireClassifyHandle0 function

The FwpsAcquireClassifyHandle0 function generates a classification handle that is used to identify asynchronous classification operations and requests for writable layer data.

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

Syntax


NTSTATUS NTAPI FwpsAcquireClassifyHandle0(
  _In_   void *classifyContext,
  _In_   UINT32 flags,
  _Out_  UINT64 *classifyHandle
);

Parameters

classifyContext [in]

The classifyContext parameter from classifyFn1. The WFP engine passes this value to the callout driver's classifyFn.

flags [in]

Reserved for future use. Set to 0.

classifyHandle [out]

A pointer to a variable that receives a classification handle. This handle is needed by subsequent function calls as noted in Remarks.

Return value

The FwpsAcquireClassifyHandle0 function returns one of the following NTSTATUS codes.

Return codeDescription
STATUS_SUCCESS

A handle to the classify request was successfully returned. The variable that the classifyHandle parameter points to contains the handle for the classify request.

Other status codes

An error occurred.

 

Remarks

FwpsAcquireClassifyHandle0 is a support function for asynchronous classification and data modification. The handle returned by this function is required as a parameter for the following functions:

For each call to this function, the callout driver must call FwpsReleaseClassifyHandle0 to free the system resources associated with the handle.

Requirements

Version

Available starting with Windows 7.

Header

Fwpsk.h (include Fwpsk.h)

IRQL

<= DISPATCH_LEVEL

See also

classifyFn
classifyFn1
FwpsCompleteClassify0
FwpsPendClassify0
FwpsReleaseClassifyHandle0

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft