FilterInstanceFindClose function (fltuser.h)

Article
02/22/2024

The FilterInstanceFindClose function closes the specified minifilter instance search handle. The FilterInstanceFindFirst and FilterInstanceFindNext functions use this search handle to locate instances of a minifilter.

Syntax

HRESULT FilterInstanceFindClose(
  [in] HANDLE hFilterInstanceFind
);

Parameters

[in] hFilterInstanceFind

Minifilter instance search handle to close. This handle must have been opened by a previous call to FilterInstanceFindFirst.

Return value

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

Remarks

After the FilterInstanceFindClose function is called, the minifilter instance search handle specified by the hFilterInstanceFind parameter cannot be used in subsequent calls to FilterInstanceFindFirst or FilterInstanceFindClose.

Use FilterInstanceFindClose to close handles returned by calls to FilterInstanceFindFirst. Use FilterInstanceClose to close handles returned by calls to FilterInstanceCreate.

Requirements

Requirement	Value
Target Platform	Universal
Header	fltuser.h (include Fltuser.h)
Library	FltLib.lib
DLL	FltLib.dll