Función FilterUnload (fltuser.h)
Una aplicación que ha cargado un minifiltro auxiliar llamando a FilterLoad puede descargar el minifiltro llamando a la función FilterUnload .
Sintaxis
HRESULT FilterUnload(
[in] LPCWSTR lpFilterName
);
Parámetros
[in] lpFilterName
Puntero a una cadena de caracteres anchos terminada en NULL que contiene el mismo nombre de minifiltro que se pasó a FilterLoad. Este parámetro es necesario y no puede ser NULL ni una cadena vacía.
Valor devuelto
FilterUnload devuelve S_OK si se ejecuta correctamente. De lo contrario, devuelve un valor de error.
Comentarios
FilterUnload es el equivalente win32 de FltUnloadFilter.
FilterUnload busca un minifiltro registrado cuyo nombre de servicio coincida con el lpFilterName especificado y llama a la rutina FilterUnloadCallback (PFLT_FILTER_UNLOAD_CALLBACK) del minifiltro.
Si el minifiltro no registró una rutina FilterUnloadCallback , se produce un error en la llamada a FilterUnload .
Los autores de llamadas de FilterUnload deben tener SeLoadDriverPrivilege (el LUID de SE_LOAD_DRIVER_PRIVILEGE) para cargar o descargar un controlador de minifiltro. Este privilegio se denomina mediante la constante de nombre SE_LOAD_DRIVER_NAME. (Los privilegios se describen en la documentación del Kit de desarrollo de software (SDK) de Microsoft Windows para Windows 7 y .NET Framework 4.0).
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | fltuser.h (incluya Fltuser.h) |
| Library | FltLib.lib |
| Archivo DLL | FltLib.dll |