FSCTL_ENUM_OVERLAY Steuerungscode

Artikel
03/14/2023

Der FSCTL_ENUM_OVERLAY-Steuerelementcode listet alle Datenquellen eines Sicherungsanbieters für ein angegebenes Volume auf.

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_REMOVE_OVERLAY .
InputBuffer [in]: Ein Zeiger auf den Eingabepuffer, der eine WOF_EXTERNAL_INFO Struktur enthalten muss.
InputBufferLength [in]: Auf sizeof(WOF_EXTERNAL_INFO) festgelegt.
OutputBuffer [out]: Zeiger auf einen Ausgabepuffer, der eine oder mehrere WIM_PROVIDER_OVERLAY_ENTRY-Strukturen für Datenquellen empfängt, die das Volume sichern.
OutputBufferLength [out]: Größe des Puffers, auf den von OutputBuffer in Bytes verwiesen wird.
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_INTERNAL_ERROR	Auf das angeforderte Volume kann nicht zugegriffen werden.
STATUS_INVALID_DEVICE_REQUEST	Der Unterstützungsdienst ist nicht vorhanden oder nicht gestartet.

Hinweise

Beim Auflisten 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, andernfalls gibt der Aufruf STATUS_BUFFER_TOO_SMALL zurück.

Zusätzliche Unterstützungsanbieter definieren ihre eigenen spezifischen Enumerationsstrukturen.