FSCTL_QUERY_PERSISTENT_VOLUME_STATE código de controle
O código de controle FSCTL_QUERY_PERSISTENT_VOLUME_STATE recupera as configurações persistentes de um volume do sistema de arquivos. As configurações persistentes permanecem em um volume do sistema de arquivos entre 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_QUERY_PERSISTENT_VOLUME_STATE para esta operação.
InputBuffer [in]: um ponteiro para uma estrutura de FILE_FS_PERSISTENT_VOLUME_INFORMATION alocada pelo chamador.
InputBufferLength [in]: o tamanho, em bytes, do buffer apontado pelo parâmetro InputBuffer .
OutputBuffer [out]: um ponteiro para uma estrutura de FILE_FS_PERSISTENT_VOLUME_INFORMATION alocada pelo chamador que recebe as configurações persistentes de um volume do sistema de arquivos.
OutputBufferLength [out]: o tamanho, em bytes, do buffer apontado pelo parâmetro OutputBuffer .
Bloco de status
FltFsControlFile ou ZwFsControlFile retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como um dos seguintes:
| Código | Significado |
|---|---|
| STATUS_NOT_SUPPORTED | 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 de FILE_FS_PERSISTENT_VOLUME_INFORMATION. |
| STATUS_BUFFER_TOO_SMALL | O buffer para o qual o parâmetro InputBuffer aponta não é grande o suficiente (ou seja, o buffer é menor que sizeof(FILE_FS_PERSISTENT_VOLUME_INFORMATION)). Nesse caso, nenhum dado de configurações persistentes é retornado. 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 ou Fltkernel.h) |