다음을 통해 공유


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

참고 항목

FsRtlMupGetProviderInfoFromFileObject

FsRtlRegisterUncProviderEx