FltSetVolumeInformation 함수(fltkernel.h)

아티클
02/06/2025

FltSetVolumeInformation 지정된 인스턴스가 연결된 볼륨에 대한 다양한 종류의 정보를 변경합니다.

통사론

NTSTATUS FLTAPI FltSetVolumeInformation(
  [in]  PFLT_INSTANCE        Instance,
  [out] PIO_STATUS_BLOCK     Iosb,
  [out] PVOID                FsInformation,
  [in]  ULONG                Length,
  [in]  FS_INFORMATION_CLASS FsInformationClass
);

매개 변수

[in] Instance

볼륨에 연결된 미니 필터 드라이버 인스턴스에 대한 불투명 인스턴스 포인터입니다.

[out] Iosb

최종 완료 상태 및 작업에 대한 정보를 수신하는 IO_STATUS_BLOCK 구조체에 대한 포인터입니다.

[out] FsInformation

볼륨에 대해 설정할 값을 포함하는 호출자 할당 버퍼에 대한 포인터입니다. 버퍼에 포함된 정보의 구조는 FsInformationClass 매개 변수에 의해 정의됩니다.

[in] Length

FsInformation이 가리키는 버퍼의 크기(바이트)입니다. 호출자는 지정된 FsInformationClass따라 이 매개 변수를 설정해야 합니다. 예를 들어 FsInformationClass 값이 FileFsControlInformation인 경우 Length 최소 sizeof(FILE_FS_CONTROL_INFORMATION)합니다.

[in] FsInformationClass

볼륨에 대해 설정할 정보 유형입니다. 다음 중 하나입니다.

값	의미
FileFsControlInformation	볼륨에 대한 FILE_FS_CONTROL_INFORMATION 설정합니다.
FileFsLabelInformation	볼륨에 대한 FILE_FS_LABEL_INFORMATION 설정합니다.
FileFsObjectIdInformation	볼륨에 대한 FILE_FS_OBJECTID_INFORMATION 설정합니다.

반환 값

FltSetVolumeInformation STATUS_SUCCESS 또는 다음 중 하나와 같은 적절한 NTSTATUS 값을 반환합니다.

반환 코드	묘사
STATUS_INFO_LENGTH_MISMATCH	Length잘못된 값이 지정되었습니다. 오류 코드입니다.
STATUS_INSUFFICIENT_RESOURCES	FltSetVolumeInformation 풀 할당 오류가 발생했습니다. 오류 코드입니다.
STATUS_INVALID_INFO_CLASS	FsInformationClass 잘못된 값이 지정되었습니다. 오류 코드입니다.
STATUS_INVALID_PARAMETER	인스턴스 네트워크 볼륨에 연결됩니다. FltSetVolumeInformation 사용하여 네트워크 볼륨 정보를 설정할 수 없습니다. 오류 코드입니다.