Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

FilterCreate function

The FilterCreate function creates a handle for the given minifilter.

Syntax


HRESULT FilterCreate(
  _In_  LPCWSTR lpFilterName,
  _Out_ HFILTER *hFilter
);

Parameters

lpFilterName [in]

Pointer to a null-terminated wide-character string containing the name of the minifilter. This parameter is required and cannot be NULL.

hFilter [out]

Pointer to a caller-allocated variable that receives a handle for the minifilter if the call to FilterCreate succeeds; otherwise, it receives INVALID_HANDLE_VALUE.

Return value

FilterCreate returns S_OK if successful. Otherwise, it returns an error value.

Remarks

A user-mode application calls FilterCreate to create a handle that can be used to communicate with a kernel-mode minifilter. The returned minifilter handle can be passed as a parameter to functions such as FilterGetInformation.

To close a filter handle returned by FilterCreate, call FilterClose.

Requirements

Target platform

Universal

Header

Fltuser.h (include Fltuser.h)

Library

FltLib.lib

DLL

FltLib.dll

See also

FilterClose
FilterGetInformation

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft