FSCTL_REMOVE_OVERLAY-Steuerelementcode

Artikel
03/14/2023

Der FSCTL_REMOVE_OVERLAY Steuercode entfernt eine Sicherungsquelle von einem Volume.

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 des Volumes, von dem die Überlagerung entfernt wird. Dieser Parameter ist erforderlich und darf nicht NULL sein.
FileHandle [in]: Nur ZwFsControlFile . Das Handle des Volumes, für das die Überlagerung entfernt 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_REMOVE_OVERLAY .
InputBuffer [in]: Ein Zeiger auf den Eingabepuffer, der eine WOF_EXTERNAL_INFO-Struktur enthalten muss. Bei Bedarf werden unmittelbar nach WOF_EXTERNAL_INFO zusätzliche anbieterspezifische Daten einbezogen. Wenn der Anbieter eine WIM-Datei ist, wird nach WOF_EXTERNAL_INFO eine WIM_PROVIDER_REMOVE_OVERLAY_INPUT-Struktur eingeschlossen.
InputBufferLength [in]: Legen Sie auf sizeof(WOF_EXTERNAL_INFO) plus die Größe aller zusätzlichen Anbietereingabedaten fest.
OutputBuffer [out]: Nicht verwendet. Auf NULL festgelegt.
OutputBufferLength [in]: 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_ACCESS_DENIED	Der Anforderer verfügt nicht über Administratorrechte.
STATUS_BUFFER_TOO_SMALL	Die Länge des Ausgabepuffers, auf den outputBuffer verweist und von OutputBufferLength angegeben wird, ist zu klein.
STATUS_INTERNAL_ERROR	Auf das angeforderte Volume kann nicht zugegriffen werden.
STATUS_INVALID_DEVICE_REQUEST	Der Unterstützungsdienst ist nicht vorhanden oder nicht gestartet.

Hinweise

Wenn die zu entfernende Sicherungsquelle eine WIM-Datei (Windows Imaging Format) ist, enthält der Eingabepuffer eine WOF_EXTERNAL_INFO-Struktur gefolgt von einer WIM_PROVIDER_REMOVE_OVERLAY_INPUT-Struktur . Der InputBufferLength ist in diesem Fall sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_REMOVE_OVERLAY_INPUT). Der DataSourceId-Wert in WIM_PROVIDER_REMOVE_OVERLAY_INPUT muss für eine WIM-Datei sein, die zuvor in einer FSCTL_ADD_OVERLAY-Anforderung hinzugefügt wurde.

Zusätzliche Unterstützungsanbieter definieren ihre eigenen spezifischen Eingabeparameterstrukturen.