Freigeben über

FSCTL_ENUM_EXTERNAL_BACKING-Steuerelementcode

  • Artikel

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)

Weitere Informationen

FltFsControlFile

ZwFsControlFile

FSCTL_GET_EXTERNAL_BACKING