Freigeben über


FSCTL_DELETE_EXTERNAL_BACKING Steuerelementcode

Der FSCTL_DELETE_EXTERNAL_BACKING Steuerelementcode entfernt die Zuordnung einer Datei mit einem externen Sicherungsanbieter, einschließlich des Windows Image Format (WIM)-Anbieters oder des komprimierten Dateianbieters. Infolge dieses Vorgangs werden die gesamten Inhalte einer gesicherten Datei gelesen, dekomprimiert und in die Datei geschrieben.

Rufen Sie zum Ausführen dieses Vorgangs FltFsControlFile- oder ZwFsControlFile- mit den folgenden Parametern auf.

Die Parameter

  • Instanz [in]: Nur FltFsControlFile . Ein undurchsichtiger Instanzzeiger 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 FSCTL_DELETE_EXTERNAL_BACKING für diesen Vorgang.

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

  • InputBufferLength [in]: Auf 0 festgelegt.

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

  • OutputBufferLength [out]: Auf 0 festlegen.

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.

Programmcode Bedeutung
STATUS_OBJECT_NOT_EXTERNALLY_BACKED Die Datei wird nicht extern gesichert.
STATUS_INVALID_DEVICE_REQUEST Der Sicherungsdienst ist nicht vorhanden oder nicht gestartet.
STATUS_ACCESS_DENIED Der Antragsteller verfügt nicht über die Berechtigung zum Löschen der Sicherungszuordnungen für die Datei.

Bemerkungen

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

Anforderungen

Anforderungstyp Anforderung
Mindest unterstützter Client Windows 8.1 Update
Kopfzeile Ntifs.h (enthalten Ntifs.h oder Fltkernel.h)

Siehe auch

FltFsControlFile-

ZwFsControlFile-

FSCTL_SET_EXTERNAL_BACKING