FSCTL_SET_PERSISTENT_VOLUME_STATE-Steuerelementcode
Der FSCTL_SET_PERSISTENT_VOLUME_STATE-Steuerungscode legt persistente Einstellungen für ein Dateisystemvolume fest. Persistente Einstellungen verbleiben zwischen Neustarts des Computers auf einem Dateisystemvolume.
Um diesen Vorgang auszuführen, rufen Sie FltFsControlFile oder ZwFsControlFile mit den folgenden Parametern auf.
Parameter
FileObject [in]: Nur FltFsControlFile . Ein Dateiobjektzeiger für das Dateisystemvolume. Dieser Parameter ist erforderlich und darf nicht NULL sein.
FileHandle [in]: Nur ZwFsControlFile . Ein Dateihandle für das Dateisystemvolume. Dieser Parameter ist erforderlich und darf nicht NULL sein.
FsControlCode [in]: Der Steuerelementcode für den Vorgang. Verwenden Sie für diesen Vorgang FSCTL_SET_PERSISTENT_VOLUME_STATE .
InputBuffer [in]: Ein Zeiger auf eine vom Aufrufer zugewiesene FILE_FS_PERSISTENT_VOLUME_INFORMATION Struktur, die die persistenten Einstellungen für ein Dateisystemvolume enthält.
InputBufferLength [in]: Die Größe des Puffers in Bytes, auf den der InputBuffer-Parameter verweist.
OutputBuffer [out]: Bei diesem Vorgang nicht verwendet; auf NULL festgelegt.
OutputBufferLength [out]: Bei diesem Vorgang nicht verwendet; auf 0 (null) festgelegt.
Statusblock
FltFsControlFile oder ZwFsControlFile gibt STATUS_SUCCESS oder einen geeigneten NTSTATUS-Wert zurück, z. B. einen der folgenden:
| Code | Bedeutung |
|---|---|
| STATUS_NOT_SUPPORTED | Die angeforderte Registrierungseinstellung ist nicht pro Volume, oder der Aufrufer hat im Versionselement von FILE_FS_PERSISTENT_VOLUME_INFORMATION eine falsche Versionsnummer angegeben. |
| STATUS_INVALID_PARAMETER | Das Dateisystemvolume ist kein geöffnetes Benutzervolume, oder der Aufrufer hat im FlagMask-Member von FILE_FS_PERSISTENT_VOLUME_INFORMATION ein ungültiges Flag angegeben. |
| STATUS_BUFFER_TOO_SMALL | Der Puffer, auf den der InputBuffer-Parameter verweist, ist nicht groß genug, um die Persistent-Settings-Daten zu enthalten. In diesem Fall werden keine Daten für persistente Einstellungen festgelegt. Dies ist ein Fehlercode. |
| STATUS_ACCESS_DENIED | Der Aufrufer kann nicht auf das Dateisystemvolume zugreifen. |
| STATUS_VOLUME_DISMOUNTED | Die Bereitstellung des Dateisystemvolumes wird aufgehoben. |
| STATUS_TOO_LATE | Das Dateisystemvolume wird heruntergefahren. |
| STATUS_MEDIA_WRITE_PROTECTED | Das Dateisystemvolume ist schreibgeschützter Datenträger. |
Anforderungen
| Anforderungstyp | Anforderung |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 |
| Header | Ntifs.h (include Ntifs.h) |