Função FilterLoad (fltuser.h)

Artigo
08/23/2023

A função FilterLoad carrega dinamicamente um driver de minifiltro no sistema.

Sintaxe

HRESULT FilterLoad(
  [in] LPCWSTR lpFilterName
);

Parâmetros

[in] lpFilterName

Ponteiro para uma cadeia de caracteres largos terminada em nulo que especifica o nome do serviço do driver de minifiltro. Esse parâmetro é necessário e não pode ser NULL ou uma cadeia de caracteres vazia.

Valor retornado

FilterLoad retornará S_OK se tiver êxito. Caso contrário, ele retornará um dos seguintes valores de erro:

Código de retorno	Descrição
HRESULT_FROM_WIN32 (ERROR_ALREADY_EXISTS)	O driver de minifiltro já está em execução.
HRESULT_FROM_WIN32 (ERROR_FILE_NOT_FOUND)	Nenhum driver de minifiltro correspondente foi encontrado.
HRESULT_FROM_WIN32 (ERROR_SERVICE_ALREADY_RUNNING)	O driver de minifiltro já está em execução.
HRESULT_FROM_WIN32 (ERROR_BAD_EXE_FORMAT)	A imagem de carregamento do driver de minifiltro especificado por lpFilterName é inválida.
HRESULT_FROM_WIN32 (ERROR_BAD_DRIVER)	A imagem de carregamento do driver de minifiltro especificado por lpFilterName é inválida.
HRESULT_FROM_WIN32 (ERROR_INVALID_IMAGE_HASH)	O driver de minifiltro tem uma assinatura digital inválida.

Comentários

FilterLoad é o equivalente a Win32 de FltLoadFilter.

Um aplicativo de modo de usuário que tem uma dependência em um driver de minifiltro no modo kernel pode carregar o driver de minifiltro chamando FilterLoad.

Os chamadores de FilterLoad devem ter SeLoadDriverPrivilege (o LUID de SE_LOAD_DRIVER_PRIVILEGE) para carregar ou descarregar um driver de minifiltro. Esse privilégio é nomeado pela constante de nome SE_LOAD_DRIVER_NAME. (Os privilégios são descritos na documentação do Microsoft Windows Software Development Kit (SDK) para Windows 7 e .NET Framework 4.0.)

Para descarregar o driver de minifiltro, chame FilterUnload.