FltMupGetProviderInfoFromFileObject 함수(fltkernel.h)
FltMupGetProviderInfoFromFileObject 파일 개체에 해당하는 공급자 정보를 검색합니다.
통사론
NTSTATUS FLTAPI FltMupGetProviderInfoFromFileObject(
PFLT_INSTANCE Instance,
PFILE_OBJECT FileObject,
ULONG Level,
PVOID Buffer,
PULONG BufferSize
);
매개 변수
Instance
[in] 이 파일 개체와 연결된 필터 인스턴스에 대한 불투명 포인터입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.
FileObject
[in] 공급자 정보를 검색할 파일 개체에 대한 포인터입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.
Level
[in] 이 루틴이 반환해야 하는 정보 수준입니다. 이 매개 변수의 가능한 값에 대한 자세한 내용은 FsRtlMupGetProviderInfoFromFileObject참조하세요.
Buffer
[out] 공급자 정보를 받는 버퍼에 대한 포인터입니다. 반환된 데이터는 지정된 수준기반으로 합니다. 이 버퍼는 Level 매개 변수에서 요청한 정보를 보관할 수 있을 만큼 커야 합니다.
BufferSize
[in/out] Buffer 매개 변수가 가리키는 버퍼의 크기를 바이트 단위로 지정하는 변수에 대한 포인터입니다. 입력 시 이 변수는 버퍼의 크기를 지정합니다. 출력에서 이 변수는 버퍼에 기록된 바이트 수를 받습니다.
반환 값
FltMupGetProviderInfoFromFileObject 작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 적절한 NTSTATUS 코드를 반환합니다.
발언
이 루틴은 FsRtlRegisterUncProviderEx사용하여 등록하는 공급자의 경우를 처리하는 데 필요합니다. 이러한 공급자에 대한 파일 개체의 디바이스 이름은 \Device\Mup
필터는 다음 용도로 이 루틴을 사용할 수 있습니다.
- 특정 리디렉션자를 필터링할 수 있습니다.
- 리디렉션자에서 가능한 버그를 해결할 수 있도록 파일 개체를 지원하는 리렉터 찾기
이 호출에 대해 MUP(여러 UNC 공급자)를 언로드할 수 없습니다.
호출자는 FileObject 호출 기간 동안 유효하도록 보장합니다.
요구 사항
요구 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 11 버전 24H2 |
헤더 | fltkernel.h |
IRQL |
<= APC_LEVEL |