Share via

FSCTL_QUERY_PERSISTENT_VOLUME_STATE codice di controllo

  • Articolo

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)

Vedi anche

FILE_FS_PERSISTENT_VOLUME_INFORMATION

FltFsControlFile

ZwFsControlFile