Freigeben über


FSCTL_DELETE_EXTERNAL_BACKING Steuerungscode

Der FSCTL_DELETE_EXTERNAL_BACKING-Steuerelementcode entfernt die Zuordnung einer Datei zu einem externen Unterstützungsanbieter, einschließlich des Windows Image Format-Anbieters (WIM) oder des komprimierten Dateianbieters. Als Ergebnis dieses Vorgangs wird der gesamte Inhalt einer gesicherten Datei gelesen, dekomprimiert und in die Datei geschrieben.

Um diesen Vorgang auszuführen, rufen Sie FltFsControlFile oder ZwFsControlFile mit den folgenden Parametern auf.

Parameter

  • Instanz [in]: Nur FltFsControlFile . Ein undurchsichtiger instance Zeiger für den Aufrufer. Dieser Parameter ist erforderlich und darf nicht NULL sein.

  • FileObject: [in]: Nur FltFsControlFile . Das Dateizeigerobjekt der Datei, für die die Sicherungszuordnung gelöscht wird. Dieser Parameter ist erforderlich und darf nicht NULL sein.

  • FileHandle [in]: nur ZwFsControlFile . Das Handle der Datei, für die die Sicherungszuordnung gelöscht wird. Dieser Parameter ist erforderlich und darf nicht NULL sein.

  • FsControlCode [in]: Der Steuerelementcode für den Vorgang. Verwenden Sie für diesen Vorgang FSCTL_DELETE_EXTERNAL_BACKING .

  • InputBuffer [in]: Keine. Auf NULL festgelegt.

  • InputBufferLength [in]: Auf 0 festgelegt.

  • OutputBuffer [out]: Keine. Auf NULL festgelegt.

  • OutputBufferLength [out]: Auf 0 festgelegt.

Statusblock

FltFsControlFile oder ZwFsControlFile gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt die entsprechende Funktion möglicherweise einen der folgenden NTSTATUS-Werte zurück.

Code Bedeutung
STATUS_OBJECT_NOT_EXTERNALLY_BACKED Die Datei wird nicht extern gesichert.
STATUS_INVALID_DEVICE_REQUEST Der Unterstützungsdienst ist nicht vorhanden oder nicht gestartet.
STATUS_ACCESS_DENIED Der Anforderer verfügt nicht über die Berechtigung, die Sicherungszuordnungen für die Datei zu löschen.

Hinweise

Als Ergebnis des Löschvorgangs wird der Inhalt der Datei aus der Sicherungsquelle gelesen, und die gesamte Datei wird auf das Volume geschrieben.

Anforderungen

Anforderungstyp Anforderung
Unterstützte Mindestversion (Client) Windows 8.1 Update
Header Ntifs.h (einschließlich Ntifs.h oder Fltkernel.h)

Weitere Informationen

FltFsControlFile

ZwFsControlFile

FSCTL_SET_EXTERNAL_BACKING