Fungsi FltSetVolumeInformation (fltkernel.h)

Artikel
02/29/2024

FltSetVolumeInformation mengubah berbagai jenis informasi tentang volume yang dilampirkan instans tertentu.

Sintaks

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

Parameter

[in] Instance

Penunjuk instans buram untuk instans driver minifilter yang dilampirkan ke volume.

[out] Iosb

Arahkan ke struktur IO_STATUS_BLOCK yang menerima status penyelesaian akhir dan informasi tentang operasi.

[out] FsInformation

Penunjuk ke buffer yang dialokasikan penelepon yang berisi nilai yang akan diatur untuk volume. Struktur informasi yang terkandung dalam buffer ditentukan oleh parameter FsInformationClass .

[in] Length

Ukuran dalam byte buffer yang dirujuk FsInformation . Pemanggil harus mengatur parameter ini sesuai dengan FsInformationClass yang diberikan. Misalnya, jika nilai FsInformationClass adalah FileFsControlInformation, Panjang harus setidaknya sizeof(FILE_FS_CONTROL_INFORMATION).

[in] FsInformationClass

Jenis informasi yang akan diatur untuk volume. Salah satu hal berikut ini.

Nilai	Makna
FileFsControlInformation	Atur FILE_FS_CONTROL_INFORMATION untuk volume.
FileFsLabelInformation	Atur FILE_FS_LABEL_INFORMATION untuk volume.
FileFsObjectIdInformation	Atur FILE_FS_OBJECTID_INFORMATION untuk volume.

Nilai kembali

FltSetVolumeInformation mengembalikan STATUS_SUCCESS atau nilai NTSTATUS yang sesuai seperti salah satu hal berikut:

Menampilkan kode	Deskripsi
STATUS_INFO_LENGTH_MISMATCH	Nilai yang tidak valid ditentukan untuk Panjang. Ini adalah kode kesalahan.
STATUS_INSUFFICIENT_RESOURCES	FltSetVolumeInformation mengalami kegagalan alokasi kumpulan. Ini adalah kode kesalahan.
STATUS_INVALID_INFO_CLASS	Nilai yang tidak valid ditentukan untuk FsInformationClass. Ini adalah kode kesalahan.
STATUS_INVALID_PARAMETER	Instans dilampirkan ke volume jaringan. FltSetVolumeInformation tidak dapat digunakan untuk mengatur informasi volume jaringan. Ini adalah kode kesalahan.