FSCTL_SHUFFLE_FILE IOCTL (ntifs.h)
FSCTL_SHUFFLE_FILE die Zuordnung innerhalb der angegebenen Datei hinzufügt oder entfernt.
Hauptcode
Eingabepuffer
Zeigen Sie auf eine SHUFFLE_FILE_DATA Struktur, die die zu zuordnende Zuordnung beschreibt.
Eingabepufferlänge
Größe in Byte des Eingabepuffers.
Ausgabepuffer
Nichts; auf NULL festgelegt.
Länge des Ausgabepuffers
Auf Null festgelegt.
Statusblock
Rückgabewerte
FSCTL_SHUFFLE_FILE gibt nach erfolgreichem Abschluss STATUS_SUCCESS zurück; andernfalls wird ein NTSTATUS-Code zurückgegeben, z. B. einen der folgenden.
| Rückgabecode | Bedeutung |
|---|---|
| STATUS_ACCESS_DENIED | Aus verschiedenen Gründen, einschließlich nur Kernelmodusaufrufen, sind zulässig, oder das Volume ist gesperrt. |
| STATUS_BUFFER_TOO_SMALL | Die angegebene Eingabepufferlänge ist kleiner als sizeof(SHUFFLE_FILE_DATA). |
| STATUS_MEDIA_WRITE_PROTECTED | Das Shuffling ist für ein schreibgeschütztes Volume nicht zulässig. |
Bemerkungen
Dieser Steuerelementcode bewirkt, dass Daten innerhalb der Datei verschoben werden. Der Aufrufer ist dafür verantwortlich, die zufälligen Daten innerhalb der hinzugefügten Zuordnung zu schützen/zu löschen.
Rufen Sie zum Ausführen dieses Vorgangs FltFsControlFile- oder ZwFsControlFile- mit den folgenden Parametern auf.
| Parameter | Beschreibung |
|---|---|
| Instanz- | [in] Nur für FltFsControlFile. Ein undurchsichtiger Instanzzeiger 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, die das Ziel dieser Anforderung ist. Dieser Parameter ist erforderlich und darf nicht NULL sein. |
| IoStatusBlock- | [out] Nur für ZwFsControlFile. Zeigen Sie auf eine IO_STATUS_BLOCK Struktur, die den endgültigen Status der Anforderung enthält. |
| FsControlCode- | [in] Auf FSCTL_SHUFFLE_FILEfestgelegt. |
| InputBuffer- | [in] Siehe IOCTL-Parameter. |
| InputBufferLength- | [in] Siehe IOCTL-Parameter. |
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10, Version 1809 |
| Header- | ntifs.h |