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_EXTERNAL_BACKING Steuerelementcode beginnt oder setzt eine Aufzählung von Dateien auf einem Volume fort, das über eine Sicherungsquelle verfügt. Für jeden erfolgreichen Abschluss der Anforderung wird ein Bezeichner für die gesicherte Datei zurückgegeben. Alle gesicherten Dateien werden unabhängig davon aufgezählt, welcher externe Anbieter sie sichert. Nachfolgende FSCTL_ENUM_EXTERNAL_BACKING Anforderungen müssen alle gesicherten Dateien auf dem Volume aufzählen.
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_ENUM_EXTERNAL_BACKING für diesen Vorgang.
InputBuffer [in]: Keine. Wird auf NULL-festgelegt.
InputBufferLength [in]: Auf 0 festgelegt.
OutputBuffer [out]: Ein Zeiger auf den Ausgabepuffer, der groß genug ist, um mindestens eine WOF_EXTERNAL_FILE_ID Strukturen zu empfangen.
OutputBufferLength [out]: Größe des Ausgabepuffers, auf den outputBuffer verweist. OutputBufferLength muss = sizeof(WOF_EXTERNAL_FILE_ID) sein>.
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_NO_MORE_FILES | Keine weiteren Dateien auf dem Volume verfügen über eine Sicherungsquelle. |
| STATUS_INTERNE_FEHLER | Auf das angeforderte Volume kann nicht zugegriffen werden. |
| STATUS_INVALID_DEVICE_REQUEST | Der Sicherungsdienst ist nicht vorhanden oder nicht gestartet. |
Bemerkungen
Die inOutputBuffer zurückgegebene WOF_EXTERNAL_FILE_ID Struktur enthält eindeutige Dateibezeichner für gesicherte Dateien. Die Struktur wird in ntifs.h wie folgt definiert.
typedef struct _WOF_EXTERNAL_FILE_ID {
FILE_ID_128 FileId;
} WOF_EXTERNAL_FILE_ID, *PWOF_EXTERNAL_FILE_ID;
Eine FSCTL_ENUM_EXTERNAL_BACKING Anforderung wird nacheinander ausgegeben, um die Bezeichner für jede Datei auf dem Volume mit Sicherungsquelle abzurufen. Wenn alle Dateien aufgezählt werden, wird der STATUS_NO_MORE_FILES Statuscode zurückgegeben.
Anforderungen
| Anforderungstyp | Anforderung |
|---|---|
| Mindest unterstützter Client | Windows 8.1 Update |
| Kopfzeile | Ntifs.h (enthalten Ntifs.h oder Fltkernel.h) |