FSCTL_SHUFFLE_FILE IOCTL (ntifs.h)

Artikel
02/26/2024

FSCTL_SHUFFLE_FILE menambahkan atau menghapus alokasi dari dalam file yang ditentukan.

Kode utama

IRP_MJ_DEVICE_CONTROL

Buffer input

Penunjuk ke struktur SHUFFLE_FILE_DATA yang menjelaskan alokasi yang akan diacak.

Panjang buffer input

Ukuran dalam byte buffer input.

Buffer output

Tidak; atur ke NULL.

Panjang buffer output

Atur ke nol.

Blok status

Mengembalikan nilai

FSCTL_SHUFFLE_FILE mengembalikan STATUS_SUCCESS setelah berhasil diselesaikan; jika tidak, ia mengembalikan kode NTSTATUS seperti salah satu dari berikut ini.

Menampilkan kode	Makna
STATUS_ACCESS_DENIED	Karena berbagai alasan, termasuk hanya panggilan mode kernel yang diizinkan, atau volume dikunci.
STATUS_BUFFER_TOO_SMALL	Panjang buffer input yang ditentukan lebih kecil dari sizeof(SHUFFLE_FILE_DATA).
STATUS_MEDIA_WRITE_PROTECTED	Pengacakan tidak diperbolehkan pada volume baca-saja.

Keterangan

Kode kontrol ini akan menyebabkan data bergeser dalam file. Penelepon bertanggung jawab untuk melindungi/menghapus data acak dalam alokasi yang ditambahkan.

Untuk melakukan operasi ini, panggil FltFsControlFile atau ZwFsControlFile dengan parameter berikut.

Parameter	Deskripsi
Instans	[in] Hanya untuk FltFsControlFile . Penunjuk instans buram untuk pemanggil. Parameter ini diperlukan dan tidak boleh NULL.
FileObject	[in] Hanya untuk FltFsControlFile . Penunjuk objek file untuk file atau direktori yang merupakan target permintaan ini. Parameter ini diperlukan dan tidak boleh NULL.
FileHandle	[in] Hanya untuk ZwFsControlFile . Handel file dari file atau direktori yang merupakan target permintaan ini. Parameter ini diperlukan dan tidak boleh NULL.
IoStatusBlock	[keluar] Hanya untuk ZwFsControlFile . Penunjuk ke struktur IO_STATUS_BLOCK yang berisi status akhir permintaan.
FsControlCode	[in] Atur ke FSCTL_SHUFFLE_FILE.
InputBuffer	[in] Lihat parameter IOCTL.
InputBufferLength	[in] Lihat parameter IOCTL.