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_ENUM_OVERLAY-Steuerelementcode listet alle Datenquellen eines Sicherungsanbieters für ein angegebenes Volume auf.
Rufen Sie zum Ausführen dieses Vorgangs FltFsControlFile- oder ZwFsControlFile- mit den folgenden Parametern auf.
Die Parameter
Instanz [in]: Nur FltFsControlFile . Undurchsichtiger Instanzzeiger für den Aufrufer. Dieser Parameter ist erforderlich und kann nicht NULL-werden.
FileObject [in]: Nur FltFsControlFile . Das Dateizeigerobjekt, das das Volume angibt, das die Bereitstellung aufheben soll. Dieser Parameter ist erforderlich und kann nicht NULL-werden.
FileHandle [in]: Nur ZwFsControlFile . Das Dateihandle des Volumes, das aufgehoben werden soll. Dieser Parameter ist erforderlich und kann nicht NULL-werden.
FsControlCode [in]: Steuerelementcode für den Vorgang. Verwenden Sie FSCTL_REMOVE_OVERLAY für diesen Vorgang.
InputBuffer [in]: Ein Zeiger auf den Eingabepuffer, der eine WOF_EXTERNAL_INFO Struktur enthalten muss.
InputBufferLength [in]: Set to sizeof(WOF_EXTERNAL_INFO).
OutputBuffer [out]: Zeiger auf einen Ausgabepuffer, der mindestens eine WIM_PROVIDER_OVERLAY_ENTRY Strukturen für Datenquellen empfängt, die das Volume sichern.
OutputBufferLength [out]: Größe des Puffers, auf den outputBuffer in Bytes verweist.
LengthReturned [out]: Gibt die Anzahl der Bytes an, die beim erfolgreichen Abschluss in OutputBuffer in OutputBuffer geschrieben wurden.
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 Ausgabepuffers, auf den OutputBuffer verweist und von OutputBufferLength 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
Beim Aufzählen der Datenquellen für den WIM-Anbieter enthält der Ausgabepuffer ein Array von WIM_PROVIDER_OVERLAY_ENTRY Strukturen. Die Größe des Ausgabepuffers muss groß genug sein, um alle Überlagerungseinträge zu enthalten, oder der Aufruf gibt STATUS_BUFFER_TOO_SMALL zurück.
Zusätzliche Sicherungsanbieter definieren ihre eigenen spezifischen Enumerationsstrukturen.
Anforderungen
| Anforderungstyp | Anforderung |
|---|---|
| Mindest unterstützter Client | Windows 8.1 Update |
| Kopfzeile | Ntifs.h (enthalten Ntifs.h oder Fltkernel.h) |