FSCTL_QUERY_PERSISTENT_VOLUME_STATE-Steuerungscode
Der FSCTL_QUERY_PERSISTENT_VOLUME_STATE-Steuerungscode ruft persistente Einstellungen für ein Dateisystemvolume ab. 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_QUERY_PERSISTENT_VOLUME_STATE .
InputBuffer [in]: Ein Zeiger auf eine aufruferseitig zugeordnete FILE_FS_PERSISTENT_VOLUME_INFORMATION-Struktur .
InputBufferLength [in]: Die Größe des Puffers in Bytes, auf den der InputBuffer-Parameter verweist.
OutputBuffer [out]: Ein Zeiger auf eine vom Aufrufer zugewiesene FILE_FS_PERSISTENT_VOLUME_INFORMATION Struktur, die die persistenten Einstellungen für ein Dateisystemvolume empfängt.
OutputBufferLength [out]: Die Größe des Puffers in Bytes, auf den der OutputBuffer-Parameter verweist.
Statusblock
FltFsControlFile oder ZwFsControlFile gibt STATUS_SUCCESS oder einen geeigneten NTSTATUS-Wert zurück, z. B. einen der folgenden:
| Code | Bedeutung |
|---|---|
| STATUS_NOT_SUPPORTED | Der Aufrufer hat eine falsche Versionsnummer im Versionsmember von FILE_FS_PERSISTENT_VOLUME_INFORMATION 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 (d. a. der Puffer ist kleiner als sizeof(FILE_FS_PERSISTENT_VOLUME_INFORMATION)). In diesem Fall werden keine Daten für persistente Einstellungen zurückgegeben. 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 (schließen Sie Ntifs.h oder Fltkernel.h ein) |