FSCTL_SHUFFLE_FILE IOCTL (ntifs.h)

Artikel
02/26/2024

FSCTL_SHUFFLE_FILE fügt die Zuordnung innerhalb der angegebenen Datei hinzu oder entfernt sie.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Zeiger auf eine SHUFFLE_FILE_DATA Struktur, die die zu mischende Zuordnung beschreibt.

Länge des Eingabepuffers

Größe des Eingabepuffers in Byte.

Ausgabepuffer

Nichts; auf NULL festgelegt.

Länge des Ausgabepuffers

Auf NULL festlegen.

Statusblock

Rückgabewerte

FSCTL_SHUFFLE_FILE gibt nach erfolgreichem Abschluss STATUS_SUCCESS zurück. Andernfalls wird ein NTSTATUS-Code wie einer der folgenden zurückgegeben.

Rückgabecode	Bedeutung
STATUS_ACCESS_DENIED	Aus verschiedenen Gründen sind nur Kernelmodusaufrufe zulässig, oder das Volume ist gesperrt.
STATUS_BUFFER_TOO_SMALL	Die angegebene Länge des Eingabepuffers ist kleiner als sizeof(SHUFFLE_FILE_DATA).
STATUS_MEDIA_WRITE_PROTECTED	Das Shuffling ist auf einem schreibgeschützten Volume nicht zulässig.

Hinweise

Dieser Steuerungscode bewirkt, dass daten innerhalb der Datei verschoben werden. Der Aufrufer ist für den Schutz/das Löschen der Zufälligen Daten innerhalb der hinzugefügten Zuordnung verantwortlich.

Um diesen Vorgang auszuführen, rufen Sie FltFsControlFile oder ZwFsControlFile mit den folgenden Parametern auf.

Parameter	BESCHREIBUNG
Instanz	[in] Nur für FltFsControlFile . Ein undurchsichtiger instance Zeiger für den Aufrufer. Dieser Parameter ist erforderlich und darf nicht NULL sein.
FileObject	[in] Nur für FltFsControlFile . Ein Dateiobjektzeiger für die Datei oder das Verzeichnis, das das Ziel dieser Anforderung ist. Dieser Parameter ist erforderlich und darf nicht NULL sein.
Filehandle	[in] Nur für ZwFsControlFile . Dateihandle der Datei oder des Verzeichnisses, das bzw. das das Ziel dieser Anforderung ist. Dieser Parameter ist erforderlich und darf nicht NULL sein.
IoStatusBlock	[out] Nur für ZwFsControlFile . Zeiger auf eine IO_STATUS_BLOCK-Struktur, die die endgültige status der Anforderung enthält.
FsControlCode	[in] Auf FSCTL_SHUFFLE_FILE festgelegt.
Inputbuffer	[in] Siehe IOCTL-Parameter.
InputBufferLength	[in] Siehe IOCTL-Parameter.