Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
FSCTL_SHUFFLE_FILE добавляет или удаляет выделение из указанного файла.
Основной код
Входной буфер
Указатель на структуру SHUFFLE_FILE_DATA, описывающую выделение для перетасовки.
Длина входного буфера
Размер входного буфера в байтах.
Выходной буфер
Никакой; задайте значение NULL.
Длина выходного буфера
Установите значение нулю.
Блок состояния
Возвращаемые значения
FSCTL_SHUFFLE_FILE возвращает STATUS_SUCCESS после успешного завершения; в противном случае возвращается код NTSTATUS, например один из следующих.
| Возвращаемый код | Значение |
|---|---|
| STATUS_ACCESS_DENIED | По разным причинам, включая только вызовы в режиме ядра, разрешены или том заблокирован. |
| STATUS_BUFFER_TOO_SMALL | Указанная длина входного буфера меньше размера (SHUFFLE_FILE_DATA). |
| STATUS_MEDIA_WRITE_PROTECTED | Перемешивание запрещено на томе только для чтения. |
Замечания
Этот код элемента управления приведет к перемещению данных в файле. Вызывающий объект отвечает за защиту или удаление случайных данных в пределах добавленного выделения.
Чтобы выполнить эту операцию, вызовите FltFsControlFile или ZwFsControlFile со следующими параметрами.
| Параметр | Описание |
|---|---|
| [in] Только для FltFsControlFile. Непрозрачный указатель экземпляра вызывающего объекта. Этот параметр является обязательным и не может иметь значение NULL. | |
| FileObject | [in] Только для FltFsControlFile. Указатель объекта файла для файла или каталога, который является целевым объектом этого запроса. Этот параметр является обязательным и не может иметь значение NULL. |
| FileHandle | [in] Только для ZwFsControlFile. Дескриптор файла или каталога, который является целевым объектом этого запроса. Этот параметр является обязательным и не может иметь значение NULL. |
| IoStatusBlock | [out] Только для ZwFsControlFile. Указатель на структуру IO_STATUS_BLOCK, содержащую окончательное состояние запроса. |
| FsControlCode | [in] Установите значение FSCTL_SHUFFLE_FILE. |
| InputBuffer | [in] См. параметры IOCTL. |
| InputBufferLength | [in] См. параметры IOCTL. |
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 10 версии 1809 |
| заголовка | ntifs.h |