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 는 FltLoadFilter와 동등한 Win32입니다.

커널 모드 미니필터 드라이버에 종속성이 있는 사용자 모드 애플리케이션은 FilterLoad를 호출하여 미니필터 드라이버를 로드할 수 있습니다.

FilterLoad 호출자는 미니필터 드라이버를 로드하거나 언로드하려면 SeLoadDriverPrivilege(SE_LOAD_DRIVER_PRIVILEGE LUID)가 있어야 합니다. 이 권한의 이름은 SE_LOAD_DRIVER_NAME 이름 상수로 지정됩니다. (권한은 Windows 7용 Microsoft SDK(Windows 소프트웨어 개발 키트) 및 .NET Framework 4.0 설명서에 설명되어 있습니다.

미니필터 드라이버를 언로드하려면 FilterUnload를 호출합니다.