FSCTL_SET_PERSISTENT_VOLUME_STATE código de controle
O código de controle FSCTL_SET_PERSISTENT_VOLUME_STATE define configurações persistentes para um volume do sistema de arquivos. As configurações persistentes permanecem em um volume do sistema de arquivos entre as reinicializações do computador.
Para executar essa operação, chame FltFsControlFile ou ZwFsControlFile com os parâmetros a seguir.
Parâmetros
FileObject [in]: somente FltFsControlFile . Um ponteiro de objeto de arquivo para o volume do sistema de arquivos. Esse parâmetro é necessário e não pode ser NULL.
FileHandle [in]: somente ZwFsControlFile . Um identificador de arquivo para o volume do sistema de arquivos. Esse parâmetro é necessário e não pode ser NULL.
FsControlCode [in]: o código de controle da operação. Use FSCTL_SET_PERSISTENT_VOLUME_STATE para esta operação.
InputBuffer [in]: um ponteiro para uma estrutura de FILE_FS_PERSISTENT_VOLUME_INFORMATION alocada pelo chamador que contém as configurações persistentes para um volume do sistema de arquivos.
InputBufferLength [in]: o tamanho, em bytes, do buffer apontado pelo parâmetro InputBuffer .
OutputBuffer [out]: não usado com esta operação; defina como NULL.
OutputBufferLength [out]: não usado com esta operação; definido como zero.
Bloco de status
FltFsControlFile ou ZwFsControlFile retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como um dos seguintes:
| Código | Significado |
|---|---|
| STATUS_NOT_SUPPORTED | A configuração do Registro solicitada não é por volume ou o chamador especificou um número de versão incorreto no membro Version do FILE_FS_PERSISTENT_VOLUME_INFORMATION. |
| STATUS_INVALID_PARAMETER | O volume do sistema de arquivos não é um volume de usuário aberto ou o chamador especificou um sinalizador inválido no membro FlagMask do FILE_FS_PERSISTENT_VOLUME_INFORMATION. |
| STATUS_BUFFER_TOO_SMALL | O buffer para o qual o parâmetro InputBuffer aponta não é grande o suficiente para manter os dados de configurações persistentes. Nesse caso, nenhum dado de configurações persistentes é definido. Este é um código de erro. |
| STATUS_ACCESS_DENIED | O chamador não pode acessar o volume do sistema de arquivos. |
| STATUS_VOLUME_DISMOUNTED | O volume do sistema de arquivos é desmontado. |
| STATUS_TOO_LATE | O volume do sistema de arquivos é desligado. |
| STATUS_MEDIA_WRITE_PROTECTED | O volume do sistema de arquivos é somente leitura. |
Requisitos
| Tipo de Requisito | Requisito |
|---|---|
| Cliente mínimo com suporte | Windows 7 |
| parâmetro | Ntifs.h (inclua Ntifs.h) |