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

FilterUnload function

An application that has loaded a supporting minifilter by calling FilterLoad can unload the minifilter by calling the FilterUnload function.

Syntax


HRESULT FilterUnload(
  _In_ LPCWSTR lpFilterName
);

Parameters

lpFilterName [in]

Pointer to a null-terminated wide-character string containing the same minifilter name that was passed to FilterLoad. This parameter is required and cannot be NULL or an empty string.

Return value

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

Remarks

FilterUnload is the Win32 equivalent of FltUnloadFilter.

FilterUnload searches for a registered minifilter whose service name matches the given lpFilterName and calls that minifilter's FilterUnloadCallback (PFLT_FILTER_UNLOAD_CALLBACK) routine.

If the minifilter did not register a FilterUnloadCallback routine, the call to FilterUnload fails.

Callers of FilterUnload must have SeLoadDriverPrivilege (the LUID of SE_LOAD_DRIVER_PRIVILEGE) to load or unload a minifilter driver. This privilege is named by the SE_LOAD_DRIVER_NAME name constant. (Privileges are described in the Microsoft Windows Software Development Kit (SDK) for Windows 7 and .NET Framework 4.0 documentation.)

Requirements

Target platform

Universal

Header

Fltuser.h (include Fltuser.h)

Library

FltLib.lib

DLL

FltLib.dll

See also

FilterLoad
FltUnloadFilter
PFLT_FILTER_UNLOAD_CALLBACK

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft