FSCTL_SHUFFLE_FILE IOCTL (ntifs.h)

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 参数。