FltSetVolumeInformation-Funktion (fltkernel.h)

Artikel
02/06/2025

FltSetVolumeInformation ändert verschiedene Arten von Informationen über das Volume, an das die angegebene Instanz angefügt ist.

Syntax

NTSTATUS FLTAPI FltSetVolumeInformation(
  [in]  PFLT_INSTANCE        Instance,
  [out] PIO_STATUS_BLOCK     Iosb,
  [out] PVOID                FsInformation,
  [in]  ULONG                Length,
  [in]  FS_INFORMATION_CLASS FsInformationClass
);

Parameter

[in] Instance

Undurchsichtiger Instanzzeiger für eine Minifiltertreiberinstanz, die an das Volume angefügt ist.

[out] Iosb

Zeigen Sie auf eine IO_STATUS_BLOCK Struktur, die den endgültigen Abschlussstatus und Informationen zum Vorgang empfängt.

[out] FsInformation

Zeigen Sie auf einen vom Aufrufer zugewiesenen Puffer, der die für das Volume festzulegenden Werte enthält. Die Struktur der im Puffer enthaltenen Informationen wird durch den FsInformationClass Parameter definiert.

[in] Length

Größe in Byte des Puffers, auf den fsInformation verweist. Der Aufrufer sollte diesen Parameter gemäß der angegebenen FsInformationClassfestlegen. Wenn beispielsweise der Wert von FsInformationClass FileFsControlInformation ist, muss Length mindestens Sizeof(FILE_FS_CONTROL_INFORMATION)sein.

[in] FsInformationClass

Typ der Informationen, die für das Volume festgelegt werden sollen. Eine der folgenden Optionen:

Wert	Bedeutung
FileFsControlInformation-	Legen Sie FILE_FS_CONTROL_INFORMATION für das Volume fest.
FileFsLabelInformation-	Legen Sie FILE_FS_LABEL_INFORMATION für das Volume fest.
FileFsObjectIdInformation-	Legen Sie FILE_FS_OBJECTID_INFORMATION für das Volume fest.

Rückgabewert

FltSetVolumeInformation gibt STATUS_SUCCESS oder einen geeigneten NTSTATUS-Wert zurück, z. B. einen der folgenden:

Rückgabecode	Beschreibung
STATUS_INFO_LENGTH_MISMATCH	Für Lengthwurde ein ungültiger Wert angegeben. Dies ist ein Fehlercode.
STATUS_INSUFFICIENT_RESOURCES	FltSetVolumeInformation ein Poolzuordnungsfehler aufgetreten. Dies ist ein Fehlercode.
STATUS_INVALID_INFO_CLASS	Für FsInformationClasswurde ein ungültiger Wert angegeben. Dies ist ein Fehlercode.
STATUS_INVALID_PARAMETER	Die Instanz- ist an ein Netzwerkvolume angefügt. FltSetVolumeInformation kann nicht zum Festlegen von Netzwerkvolumeinformationen verwendet werden. Dies ist ein Fehlercode.