FSCTL_QUERY_PERSISTENT_VOLUME_STATE codice di controllo
Il codice di controllo FSCTL_QUERY_PERSISTENT_VOLUME_STATE recupera le impostazioni persistenti per un volume del file system. Le impostazioni persistenti rimangono in un volume del file system tra i riavvii del computer.
Per eseguire questa operazione, chiamare FltFsControlFile o ZwFsControlFile con i parametri seguenti.
Parametri
FileObject [in]: Solo FltFsControlFile . Puntatore a oggetti file per il volume del file system. Questo parametro è obbligatorio e non può essere NULL.
FileHandle [in]: ZwFsControlFile solo. Handle di file per il volume del file system. Questo parametro è obbligatorio e non può essere NULL.
FsControlCode [in]: codice di controllo per l'operazione. Usare FSCTL_QUERY_PERSISTENT_VOLUME_STATE per questa operazione.
InputBuffer [in]: puntatore a una struttura FILE_FS_PERSISTENT_VOLUME_INFORMATION allocata dal chiamante.
InputBufferLength [in]: dimensioni, in byte, del buffer a cui punta il parametro InputBuffer .
OutputBuffer [out]: puntatore a una struttura FILE_FS_PERSISTENT_VOLUME_INFORMATION allocata dal chiamante che riceve le impostazioni persistenti per un volume del file system.
OutputBufferLength [out]: dimensioni, in byte, del buffer a cui punta il parametro OutputBuffer .
Blocco dello stato
FltFsControlFile o ZwFsControlFile restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio uno dei seguenti:
| Codice | Significato |
|---|---|
| STATUS_NOT_SUPPORTED | Il chiamante ha specificato un numero di versione non corretto nel membro Version di FILE_FS_PERSISTENT_VOLUME_INFORMATION. |
| STATUS_INVALID_PARAMETER | Il volume del file system non è un volume utente aperto o il chiamante ha specificato un flag non valido nel membro FlagMask di FILE_FS_PERSISTENT_VOLUME_INFORMATION. |
| STATUS_BUFFER_TOO_SMALL | Il buffer a cui punta il parametro InputBuffer non è sufficiente, ovvero il buffer è minore di sizeof(FILE_FS_PERSISTENT_VOLUME_INFORMATION)). In questo caso, non vengono restituiti dati delle impostazioni persistenti. Si tratta di un codice di errore. |
| STATUS_ACCESS_DENIED | Il chiamante non può accedere al volume del file system. |
| STATUS_VOLUME_DISMOUNTED | Il volume del file system è smontato. |
| STATUS_TOO_LATE | Il volume del file system viene arrestato. |
| STATUS_MEDIA_WRITE_PROTECTED | Il volume del file system è di sola lettura. |
Requisiti
| Tipo di requisito | Requisito |
|---|---|
| Client minimo supportato | Windows 7 |
| Intestazione | Ntifs.h (include Ntifs.h o Fltkernel.h) |