Fungsi FltSetVolumeInformation (fltkernel.h)

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.

Mengembalikan nilai

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.

Keterangan

Untuk mengkueri informasi tentang volume, panggil FltQueryVolumeInformation.

Persyaratan

   
Target Platform Universal
Header fltkernel.h (termasuk Fltkernel.h)
Pustaka FltMgr.lib
DLL Fltmgr.sys
IRQL PASSIVE_LEVEL

Lihat juga

FILE_FS_CONTROL_INFORMATION

FILE_FS_LABEL_INFORMATION

FILE_FS_OBJECTID_INFORMATION

FltQueryVolumeInformation