Funzione FilterLoad (fltuser.h)

Articolo
08/23/2023

La funzione FilterLoad carica dinamicamente un driver minifilter nel sistema.

Sintassi

HRESULT FilterLoad(
  [in] LPCWSTR lpFilterName
);

Parametri

[in] lpFilterName

Puntatore a una stringa di caratteri wide con terminazione Null che specifica il nome del servizio del driver minifilter. Questo parametro è obbligatorio e non può essere NULL o una stringa vuota.

Valore restituito

FilterLoad restituisce S_OK in caso di esito positivo. In caso contrario, restituisce uno dei valori di errore seguenti:

Codice restituito	Descrizione
HRESULT_FROM_WIN32 (ERROR_ALREADY_EXISTS)	Il driver minifilter è già in esecuzione.
HRESULT_FROM_WIN32 (ERROR_FILE_NOT_FOUND)	Non è stato trovato alcun driver minifilter corrispondente.
HRESULT_FROM_WIN32 (ERROR_SERVICE_ALREADY_RUNNING)	Il driver minifilter è già in esecuzione.
HRESULT_FROM_WIN32 (ERROR_BAD_EXE_FORMAT)	L'immagine di caricamento per il driver minifilter specificato da lpFilterName non è valida.
HRESULT_FROM_WIN32 (ERROR_BAD_DRIVER)	L'immagine di caricamento per il driver minifilter specificato da lpFilterName non è valida.
HRESULT_FROM_WIN32 (ERROR_INVALID_IMAGE_HASH)	Il driver minifilter ha una firma digitale non valida.

Commenti

FilterLoad è l'equivalente Win32 di FltLoadFilter.

Un'applicazione in modalità utente che ha una dipendenza da un driver minifilter in modalità kernel può caricare il driver minifilter chiamando FilterLoad.

I chiamanti di FilterLoad devono avere SeLoadDriverPrivilege (il LUID di SE_LOAD_DRIVER_PRIVILEGE) per caricare o scaricare un driver minifilter. Questo privilegio viene denominato dalla costante nome SE_LOAD_DRIVER_NAME. I privilegi sono descritti nella documentazione di Microsoft Windows Software Development Kit (SDK) per Windows 7 e .NET Framework 4.0.

Per scaricare il driver minifilter, chiamare FilterUnload.