Função FilterUnload (fltuser.h)
Um aplicativo que carregou um minifiltro de suporte chamando FilterLoad pode descarregar o minifiltro chamando a função FilterUnload .
Sintaxe
HRESULT FilterUnload(
[in] LPCWSTR lpFilterName
);
Parâmetros
[in] lpFilterName
Ponteiro para uma cadeia de caracteres largos terminada em nulo que contém o mesmo nome de minifiltro que foi passado para FilterLoad. Esse parâmetro é necessário e não pode ser NULL ou uma cadeia de caracteres vazia.
Retornar valor
FilterUnload retornará S_OK se tiver êxito. Caso contrário, ele retornará um valor de erro.
Comentários
FilterUnload é o equivalente a Win32 de FltUnloadFilter.
FilterUnload procura um minifiltro registrado cujo nome de serviço corresponde ao lpFilterName fornecido e chama a rotina FilterUnloadCallback (PFLT_FILTER_UNLOAD_CALLBACK) do minifiltro.
Se o minifiltro não registrou uma rotina FilterUnloadCallback , a chamada para FilterUnload falhará.
Os chamadores de FilterUnload 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.)
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Cabeçalho | fltuser.h (inclua Fltuser.h) |
| Biblioteca | FltLib.lib |
| DLL | FltLib.dll |