FSCTL_SHUFFLE_FILE IOCTL (ntifs.h)
FSCTL_SHUFFLE_FILE agrega o quita la asignación del archivo especificado.
Código principal
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; establézcalo en NULL.
Longitud del búfer de salida
Establézcalo en cero.
Bloque de estado
Valores devueltos
FSCTL_SHUFFLE_FILE devuelve STATUS_SUCCESS tras la finalización correcta; de lo contrario, devuelve un código NTSTATUS como uno de los siguientes.
| Código devuelto | Significado |
|---|---|
| STATUS_ACCESS_DENIED | Por varias razones, se permiten solo las 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. |
Observaciones
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 de | [in] Solo para FltFsControlFile. Puntero de instancia opaco para el autor de la llamada. Este parámetro es necesario y no puede ser NULL. |
| FileObject de |
[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 necesario y no puede ser NULL. |
| FileHandle de |
[in] Solo para ZwFsControlFile. Identificador de archivo del archivo o directorio que es el destino de esta solicitud. Este parámetro es necesario y no puede ser NULL. |
| |
[out] Solo para ZwFsControlFile. Puntero a una estructura 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. |
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 10, versión 1809 |
| encabezado de |
ntifs.h |
Consulte también
fltFsControlFile de