Función FilterLoad (fltuser.h)

Artículo
08/23/2023

La función FilterLoad carga dinámicamente un controlador de minifiltro en el sistema.

Sintaxis

HRESULT FilterLoad(
  [in] LPCWSTR lpFilterName
);

Parámetros

[in] lpFilterName

Puntero a una cadena de caracteres anchos terminada en NULL que especifica el nombre de servicio del controlador de minifiltro. Este parámetro es necesario y no puede ser NULL ni una cadena vacía.

Valor devuelto

FilterLoad devuelve S_OK si se ejecuta correctamente. De lo contrario, devuelve uno de los siguientes valores de error:

Código devuelto	Descripción
HRESULT_FROM_WIN32 (ERROR_ALREADY_EXISTS)	El controlador de minifiltro ya se está ejecutando.
HRESULT_FROM_WIN32 (ERROR_FILE_NOT_FOUND)	No se encontró ningún controlador de minifiltro coincidente.
HRESULT_FROM_WIN32 (ERROR_SERVICE_ALREADY_RUNNING)	El controlador de minifiltro ya se está ejecutando.
HRESULT_FROM_WIN32 (ERROR_BAD_EXE_FORMAT)	La imagen de carga del controlador de minifiltro especificado por lpFilterName no es válida.
HRESULT_FROM_WIN32 (ERROR_BAD_DRIVER)	La imagen de carga del controlador de minifiltro especificado por lpFilterName no es válida.
HRESULT_FROM_WIN32 (ERROR_INVALID_IMAGE_HASH)	El controlador de minifiltro tiene una firma digital no válida.

Comentarios

FilterLoad es el equivalente de Win32 de FltLoadFilter.

Una aplicación en modo de usuario que tiene una dependencia en un controlador de minifiltro en modo kernel puede cargar el controlador de minifiltro llamando a FilterLoad.

Los autores de llamadas de FilterLoad 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).

Para descargar el controlador de minifiltro, llame a FilterUnload.