FSCTL_ENUM_EXTERNAL_BACKING-Steuerelementcode
Der FSCTL_ENUM_EXTERNAL_BACKING-Steuerelementcode beginnt oder setzt eine Enumeration von Dateien auf einem Volume fort, die über eine Sicherungsquelle verfügen. Für jeden erfolgreichen Abschluss der Anforderung wird ein Bezeichner für die gesicherte Datei zurückgegeben. Alle gesicherten Dateien werden aufgelistet, unabhängig davon, welcher externe Anbieter sie unterstützt. Nachfolgende FSCTL_ENUM_EXTERNAL_BACKING Anforderungen sind erforderlich, um alle gesicherten Dateien auf dem Volume aufzulisten.
Um diesen Vorgang auszuführen, rufen Sie FltFsControlFile oder ZwFsControlFile mit den folgenden Parametern auf.
Parameter
Instanz [in]: Nur FltFsControlFile . Undurchsichtiger instance Zeiger für den Aufrufer. Dieser Parameter ist erforderlich und darf nicht NULL sein.
FileObject [in]: Nur FltFsControlFile . Das Dateizeigerobjekt, das das Volume angibt, das aufgehoben werden soll. Dieser Parameter ist erforderlich und darf nicht NULL sein.
FileHandle [in]: nur ZwFsControlFile . Das Dateihandle des Volumes, das die Bereitstellung aufheben soll. Dieser Parameter ist erforderlich und darf nicht NULL sein.
FsControlCode [in]: Steuerungscode für den Vorgang. Verwenden Sie für diesen Vorgang FSCTL_ENUM_EXTERNAL_BACKING .
InputBuffer [in]: Keine. Auf NULL festgelegt.
InputBufferLength [in]: Auf 0 festgelegt.
OutputBuffer [out]: Ein Zeiger auf den Ausgabepuffer, der eine Größe aufweisen muss, die groß genug ist, um eine oder mehrere WOF_EXTERNAL_FILE_ID-Strukturen zu empfangen.
OutputBufferLength [out]: Größe des Ausgabepuffers, auf den von OutputBuffer verwiesen wird. OutputBufferLength muss = sizeof(WOF_EXTERNAL_FILE_ID) sein>.
LengthReturned [out]: Gibt die Anzahl der Bytes an, die bei erfolgreicher Fertigstellung 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.
| 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_NO_MORE_FILES | Keine weiteren Dateien auf dem Volume verfügen über eine Sicherungsquelle. |
| 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
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 der Sicherungsquelle abzurufen. Wenn alle Dateien aufgelistet werden, wird der STATUS_NO_MORE_FILES status Code zurückgegeben.
Anforderungen
| Anforderungstyp | Anforderung |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8.1 Update |
| Header | Ntifs.h (einschließlich Ntifs.h oder Fltkernel.h) |