FSCTL_SHUFFLE_FILE IOCTL (ntifs.h)

Artículo
02/26/2024

FSCTL_SHUFFLE_FILE agrega o quita la asignación del archivo especificado.

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

Puntero a una estructura de SHUFFLE_FILE_DATA que describe la asignación que se va a ordenar aleatoriamente.

Longitud del búfer de entrada

Tamaño en bytes del búfer de entrada.

Búfer de salida

Ninguno; se establece en NULL.

Longitud del búfer de salida

Establecer en cero.

Bloque de estado

Valores devueltos

FSCTL_SHUFFLE_FILE devuelve STATUS_SUCCESS tras completarse correctamente; de lo contrario, devuelve un código NTSTATUS, como uno de los siguientes.

Código de retorno	Significado
STATUS_ACCESS_DENIED	Por varias razones, se permiten solo llamadas en modo kernel o el volumen está bloqueado.
STATUS_BUFFER_TOO_SMALL	La longitud del búfer de entrada especificada es menor que sizeof(SHUFFLE_FILE_DATA).
STATUS_MEDIA_WRITE_PROTECTED	No se permite el orden aleatorio en un volumen de solo lectura.

Comentarios

Este código de control hará que los datos cambien dentro del archivo. El autor de la llamada es responsable de proteger o borrar los datos aleatorios dentro de la asignación agregada.

Para realizar esta operación, llame a FltFsControlFile o ZwFsControlFile con los parámetros siguientes.

Parámetro	Descripción
Instancia	[in] Solo para FltFsControlFile . Puntero de instancia opaco para el autor de la llamada. Este parámetro es obligatorio y no puede ser NULL.
FileObject	[in] Solo para FltFsControlFile . Puntero de objeto de archivo para el archivo o directorio que es el destino de esta solicitud. Este parámetro es obligatorio y no puede ser NULL.
FileHandle	[in] Solo para ZwFsControlFile . Identificador de archivo del archivo o directorio que es el destino de esta solicitud. Este parámetro es obligatorio y no puede ser NULL.
IoStatusBlock	[out] Solo para ZwFsControlFile . Puntero a una estructura de IO_STATUS_BLOCK que contiene el estado final de la solicitud.
FsControlCode	[in] Establezca en FSCTL_SHUFFLE_FILE.
InputBuffer	[in] Consulte parámetros de IOCTL.
InputBufferLength	[in] Consulte parámetros de IOCTL.