FSCTL_DELETE_EXTERNAL_BACKING Steuerungscode

Artikel
02/02/2024

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.