Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Der FSCTL_UPDATE_OVERLAY-Steuerelementcode aktualisiert einen neuen Datenquellenbezeichner für eine Sicherungsquelle, die an ein Volume angefügt ist.
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 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 die Überlagerung aktualisiert wird. Dieser Parameter ist erforderlich und darf nicht NULL sein.
FsControlCode [in]: Der Steuerelementcode für den Vorgang. Verwenden Sie FSCTL_UPDATE_OVERLAY für diesen Vorgang.
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_UPDATE_OVERLAY_INPUT Struktur eingeschlossen.
InputBufferLength [in]: Set to sizeof(WOF_EXTERNAL_INFO) plus the size of any additional provider input data.
OutputBuffer [out]: Nicht verwendet. Auf NULL festgelegt.
OutputBufferLength [in]: 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_ACCESS_DENIED | Der Antragsteller 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_INTERNE_FEHLER | Auf das angeforderte Volume kann nicht zugegriffen werden. |
| STATUS_INVALID_DEVICE_REQUEST | Der Sicherungsdienst ist nicht vorhanden oder nicht gestartet. |
Bemerkungen
Wenn es sich bei der zu aktualisierenden Datenquelle um eine WIM-Datei (Windows Imaging Format) handelt, enthält der Eingabepuffer eine WOF_EXTERNAL_INFO Struktur gefolgt von einer WIM_PROVIDER_UPDATE_OVERLAY_INPUT Struktur. Der InputBufferLength in diesem Fall ist 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 in einer FSCTL_ADD_OVERLAY Anforderung hinzugefügt wurde.
Andere Sicherungsanbieter definieren ihre eigenen spezifischen Eingabeparameterstrukturen.
Anforderungen
| Anforderungstyp | Anforderung |
|---|---|
| Mindest unterstützter Client | Windows 8.1 Update |
| Kopfzeile | Ntifs.h (enthalten Ntifs.h oder Fltkernel.h) |