Fungsi ZwSetVolumeInformationFile (ntifs.h)

Artikel
08/07/2023

Rutinitas ZwSetVolumeInformationFile memodifikasi informasi tentang volume yang terkait dengan file, direktori, perangkat penyimpanan, atau volume tertentu.

Sintaks

NTSYSAPI NTSTATUS ZwSetVolumeInformationFile(
  [in]  HANDLE               FileHandle,
  [out] PIO_STATUS_BLOCK     IoStatusBlock,
  [in]  PVOID                FsInformation,
  [in]  ULONG                Length,
  [in]  FS_INFORMATION_CLASS FsInformationClass
);

Parameter

[in] FileHandle

Tangani ke objek file untuk file terbuka, direktori, perangkat penyimpanan, atau volume yang informasi volumenya akan dimodifikasi.

[out] IoStatusBlock

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

[in] FsInformation

Penunjuk ke buffer yang dialokasikan penelepon yang berisi informasi volume yang akan dimodifikasi. Struktur informasi dalam buffer ini tergantung pada nilai FsInformationClass, seperti yang ditunjukkan dalam tabel berikut.

[in] Length

Ukuran dalam byte buffer yang diacu oleh FsInformation. Pemanggil harus mengatur parameter ini sesuai dengan FsInformationClass yang diberikan.

[in] FsInformationClass

Jenis informasi volume yang akan diatur. Salah satu dari 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

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

Menampilkan kode	Deskripsi
STATUS_INFO_LENGTH_MISMATCH	Nilai yang tidak valid ditentukan untuk Panjang. Ini adalah kode kesalahan.
STATUS_INSUFFICIENT_RESOURCES	ZwSetVolumeInformationFile mengalami kegagalan alokasi kumpulan. Ini adalah kode kesalahan.
STATUS_INVALID_INFO_CLASS	Nilai yang tidak valid ditentukan untuk FsInformationClass. Ini adalah kode kesalahan.

Keterangan

Untuk mengkueri informasi volume, panggil ZwQueryVolumeInformationFile.

Untuk mengubah informasi tentang file, panggil ZwSetVolumeInformationFile.

Minifilter harus menggunakan FltSetInformationFile alih-alih ZwSetVolumeInformationFile.

Catatan Jika panggilan ke fungsi ZwSetVolumeInformationFileterjadi dalam mode pengguna, Anda harus menggunakan nama "NtSetInformationFile" alih-alih "ZwSetVolumeInformationFile".

Untuk panggilan dari driver mode kernel, versi NtXxx dan ZwXxx dari rutinItas Windows Native System Services dapat berperilaku berbeda dalam cara mereka menangani dan menginterpretasikan parameter input. Untuk informasi selengkapnya tentang hubungan antara versi NtXxx dan ZwXxx dari rutinitas, lihat Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Server 2003
Target Platform	Universal
Header	ntifs.h (termasuk Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Aturan kepatuhan DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)