FwpsAcquireClassifyHandle0 - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// fwpsk.h

NTSTATUS FwpsAcquireClassifyHandle0(
  [in]  void   *classifyContext,
  [in]  UINT32 flags,
  [out] UINT64 *classifyHandle
);

View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nf-fwpsk-fwpsacquireclassifyhandle0)

FwpsAcquireClassifyHandle0 function

Description

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.

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 code Description
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.

See also

FwpsCompleteClassify0

FwpsPendClassify0

FwpsReleaseClassifyHandle0

classifyFn

classifyFn1