FilterUnload 함수(fltuser.h)

아티클
02/26/2024

FilterLoad를 호출하여 지원 미니필터를 로드한 애플리케이션은 FilterUnload 함수를 호출하여 미니필터를 언로드할 수 있습니다.

구문

HRESULT FilterUnload(
  [in] LPCWSTR lpFilterName
);

매개 변수

[in] lpFilterName

FilterLoad에 전달된 동일한 미니필터 이름을 포함하는 null로 끝나는 와이드 문자열에 대한 포인터입니다. 이 매개 변수는 필수이며 NULL 또는 빈 문자열일 수 없습니다.

반환 값

FilterUnload는 성공하면 S_OK 반환합니다. 그렇지 않으면 오류 값이 반환됩니다.

설명

FilterUnload 는 FltUnloadFilter에 해당하는 Win32입니다.

FilterUnload 는 서비스 이름이 지정된 lpFilterName 과 일치하는 등록된 미니필터를 검색하고 해당 미니필터의 FilterUnloadCallback (PFLT_FILTER_UNLOAD_CALLBACK) 루틴을 호출합니다.

미니필터가 FilterUnloadCallback 루틴을 등록하지 않은 경우 FilterUnload 호출이 실패합니다.

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