FSCTL_GET_EXTERNAL_BACKING-Steuerelementcode

Artikel
02/12/2024

Der FSCTL_GET_EXTERNAL_BACKING-Steuerelementcode ruft die Sicherungsinformationen für eine Datei von einem externen Sicherungsanbieter ab. Zu den Unterstützungsanbietern gehören der Windows Image Format-Anbieter (WIM) oder ein einzelner komprimierter Dateianbieter. Inhalte für extern gesicherte Dateien können sich auf anderen Volumes als auf dem Volume befinden, das die abgefragte Datei enthält.

Um diesen Vorgang auszuführen, rufen Sie FltFsControlFile oder ZwFsControlFile mit den folgenden Parametern auf.

Parameter

Instanz [in]: Nur FltFsControlFile . Ein undurchsichtiger instance Zeiger für den Aufrufer. Dieser Parameter ist erforderlich und darf nicht NULL sein.
FileObject [in]: Nur FltFsControlFile . Das Dateizeigerobjekt der Datei, für die Sicherungsinformationen abgefragt werden. Dieser Parameter ist erforderlich und darf nicht NULL sein.
FileHandle [in]: Nur ZwFsControlFile . Das Handle der Datei, für die Sicherungsinformationen abgefragt werden. Dieser Parameter ist erforderlich und darf nicht NULL sein.
FsControlCode [in]: Ein Steuerelementcode für den Vorgang. Verwenden Sie für diesen Vorgang FSCTL_GET_EXTERNAL_BACKING .
InputBuffer [in]: Keine. Auf NULL festgelegt.
InputBufferLength [in]: Auf 0 festgelegt.
OutputBuffer [out]: Ein Zeiger auf den Ausgabepuffer, der groß genug sein muss, um eine WOF_EXTERNAL_INFO-Struktur gefolgt von den Anbieterdaten zu empfangen. Auf WOF_EXTERNAL_INFO von WIM gesicherten Dateien folgt eine WIM_PROVIDER_EXTERNAL_INFO-Struktur . Bei einzeln komprimierten Dateien folgt auf WOF_EXTERNAL_INFO eine FILE_PROVIDER_EXTERNAL_INFO_V1-Struktur .
OutputBufferLength [out]: Größe des Puffers, auf den outputBuffer verweist, in Bytes.
LengthReturned [out]: Gibt die Anzahl der Bytes an, die bei erfolgreicher Fertigstellung in OutputBuffer geschrieben werden.

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_OBJECT_NOT_EXTERNALLY_BACKED	Die Datei ist nicht extern gesichert.
STATUS_INVALID_DEVICE_REQUEST	Der Unterstützungsdienst ist nicht vorhanden oder nicht gestartet.

Hinweise

Wenn der Sicherungsanbieter für die zu aktualisierende Datenquelle eine WIM-Datei ist, enthält der Ausgabepuffer eine WOF_EXTERNAL_INFO-Struktur gefolgt von einer WIM_PROVIDER_EXTERNAL_INFO-Struktur . OutputBufferLength muss mindestens sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_EXTERNAL_INFO) sein. Wenn der Sicherungsanbieter eine einzeln komprimierte Datei ist, enthält der Ausgabepuffer eine WOF_EXTERNAL_INFO-Struktur gefolgt von einer FILE_PROVIDER_EXTERNAL_INFO_V1-Struktur .