FilterLoad 函式 (fltuser.h)

發行項
08/23/2023

FilterLoad函式會動態將迷你篩選驅動程式載入系統。

語法

HRESULT FilterLoad(
  [in] LPCWSTR lpFilterName
);

參數

[in] lpFilterName

指定迷你篩選驅動程式服務名稱之 Null 終止寬字元字串的指標。這是必要參數，不能是 Null 或空字串。

傳回值

如果成功，FilterLoad會傳回S_OK。否則，它會傳回下列其中一個錯誤值：

傳回碼	描述
HRESULT_FROM_WIN32 (ERROR_ALREADY_EXISTS)	迷你篩選驅動程式已在執行中。
HRESULT_FROM_WIN32 (ERROR_FILE_NOT_FOUND)	找不到相符的迷你篩選驅動程式。
HRESULT_FROM_WIN32 (ERROR_SERVICE_ALREADY_RUNNING)	迷你篩選驅動程式已在執行中。
HRESULT_FROM_WIN32 (ERROR_BAD_EXE_FORMAT)	lpFilterName所指定迷你篩選驅動程式的載入映射無效。
HRESULT_FROM_WIN32 (ERROR_BAD_DRIVER)	lpFilterName所指定迷你篩選驅動程式的載入映射無效。
HRESULT_FROM_WIN32 (ERROR_INVALID_IMAGE_HASH)	迷你篩選驅動程式具有不正確數位簽章。

備註

FilterLoad 是 Win32 對等的 FltLoadFilter。

具有核心模式迷你篩選驅動程式相依性的使用者模式應用程式，可以藉由呼叫 FilterLoad來載入迷你篩選驅動程式。

FilterLoad的呼叫端必須具有SeLoadDriverPrivilege (SE_LOAD_DRIVER_PRIVILEGE) 的 LUID，才能載入或卸載迷你篩選驅動程式。此許可權是由SE_LOAD_DRIVER_NAME名稱常數命名。 microsoft Windows 軟體發展工具組 (SDK) for Windows 7 和 .NET Framework 4.0 檔.) 說明 (許可權

若要卸載迷你篩選驅動程式，請呼叫 FilterUnload。