FSCTL_SHUFFLE_FILE IOCTL (ntifs.h)
FSCTL_SHUFFLE_FILE adiciona ou remove a alocação de dentro do arquivo especificado.
Código principal
Buffer de entrada
Ponteiro para uma estrutura SHUFFLE_FILE_DATA que descreve a alocação a ser embaralhada.
Comprimento do buffer de entrada
Tamanho em bytes do buffer de entrada.
Buffer de saída
Nenhum; definido como NULL.
Comprimento do buffer de saída
Definido como zero.
Bloco de status
Valores retornados
FSCTL_SHUFFLE_FILE retorna STATUS_SUCCESS após a conclusão bem-sucedida; caso contrário, ele retorna um código NTSTATUS, como um dos seguintes.
| Código de retorno | Significado |
|---|---|
| STATUS_ACCESS_DENIED | Por vários motivos, incluindo apenas chamadas no modo kernel são permitidas ou o volume está bloqueado. |
| STATUS_BUFFER_TOO_SMALL | O comprimento do buffer de entrada especificado é menor que sizeof(SHUFFLE_FILE_DATA). |
| STATUS_MEDIA_WRITE_PROTECTED | O embaralhamento não é permitido em um volume somente leitura. |
Observações
Esse código de controle fará com que os dados sejam deslocados dentro do arquivo. O chamador é responsável por proteger/apagar os dados aleatórios dentro da alocação adicionada.
Para executar essa operação, chame FltFsControlFile ou ZwFsControlFile com os parâmetros a seguir.
| Parâmetro | Descrição |
|---|---|
| da Instância de |
[in] Para FltFsControlFile. Um ponteiro de instância opaco para o chamador. Esse parâmetro é necessário e não pode ser NULL. |
| FileObject | [in] Para FltFsControlFile. Um ponteiro de objeto de arquivo para o arquivo ou diretório que é o destino dessa solicitação. Esse parâmetro é necessário e não pode ser NULL. |
| |
[in] Para ZwFsControlFile. Identificador de arquivo do arquivo ou diretório que é o destino desta solicitação. Esse parâmetro é necessário e não pode ser NULL. |
| IoStatusBlock | [out] Para ZwFsControlFile. Ponteiro para uma estrutura IO_STATUS_BLOCK que contém o status final da solicitação. |
| FsControlCode | [in] Definido como FSCTL_SHUFFLE_FILE. |
| InputBuffer | [in] Consulte os parâmetros IOCTL. |
| InputBufferLength | [in] Consulte os parâmetros IOCTL. |
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 10, versão 1809 |
| cabeçalho | ntifs.h |
Consulte também