FSCTL_UPDATE_OVERLAY Steuerungscode

Artikel
03/14/2023

Der FSCTL_UPDATE_OVERLAY-Steuerelementcode aktualisiert einen neuen Datenquellenbezeichner für eine an ein Volume angefügte Sicherungsquelle.

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, für das die Überlagerung aktualisiert wird. Dieser Parameter ist erforderlich und darf nicht NULL sein.
FileHandle [in]: nur ZwFsControlFile . Das Handle des Volumes, für das das Overlay aktualisiert 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_UPDATE_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 eingeschlossen. Wenn es sich bei dem Anbieter um eine WIM-Datei handelt, wird nach WOF_EXTERNAL_INFO eine WIM_PROVIDER_UPDATE_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 Eingabepuffers, auf den inputBuffer verweist und von InputBufferLength 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 aktualisierende Datenquelle eine WIM-Datei (Windows Imaging Format) ist, enthält der Eingabepuffer eine WOF_EXTERNAL_INFO-Struktur gefolgt von einer WIM_PROVIDER_UPDATE_OVERLAY_INPUT-Struktur . Die InputBufferLength lautet in diesem Fall sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_UPDATE_OVERLAY_INPUT). Der DataSourceId-Wert in WIM_PROVIDER_UPDATE_OVERLAY_INPUT muss für eine WIM-Datei sein, die zuvor einer FSCTL_ADD_OVERLAY Anforderung hinzugefügt wurde.

Andere Unterstützungsanbieter definieren ihre eigenen spezifischen Eingabeparameterstrukturen.