FSCTL_SET_PERSISTENT_VOLUME_STATE codice di controllo
Il codice di controllo FSCTL_SET_PERSISTENT_VOLUME_STATE imposta 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_SET_PERSISTENT_VOLUME_STATE per questa operazione.
InputBuffer [in]: puntatore a una struttura FILE_FS_PERSISTENT_VOLUME_INFORMATION allocata dal chiamante che contiene le impostazioni persistenti per un volume del file system.
InputBufferLength [in]: dimensioni, in byte, del buffer a cui punta il parametro InputBuffer .
OutputBuffer [out]: non usato con questa operazione; impostato su NULL.
OutputBufferLength [out]: non usato con questa operazione; impostato su zero.
Blocco dello stato
FltFsControlFile o ZwFsControlFile restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio uno dei seguenti:
| Codice | Significato |
|---|---|
| STATUS_NOT_SUPPORTED | L'impostazione del Registro di sistema richiesta non è per volume o 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 per contenere i dati delle impostazioni persistenti. In questo caso, non vengono impostati 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) |