FltSetVolumeInformation-Funktion (fltkernel.h)

Artikel
02/26/2024

FltSetVolumeInformation ändert verschiedene Arten von Informationen über das Volume, an das die angegebene instance 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 instance Zeiger für einen Minifiltertreiber instance, der an das Volume angefügt ist.

[out] Iosb

Zeiger auf eine IO_STATUS_BLOCK-Struktur, die die endgültige Vervollständigung status und Informationen zum Vorgang empfängt.

[out] FsInformation

Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der die werte enthält, die für das Volume festgelegt werden sollen. Die Struktur der im Puffer enthaltenen Informationen wird durch den FsInformationClass-Parameter definiert.

[in] Length

Größe in Bytes des Puffers, auf den FsInformation verweist. Der Aufrufer sollte diesen Parameter entsprechend der angegebenen FsInformationClass festlegen. Wenn der Wert von FsInformationClass beispielsweise 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:

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 entsprechenden NTSTATUS-Wert zurück, z. B. einen der folgenden:

Rückgabecode	Beschreibung
STATUS_INFO_LENGTH_MISMATCH	Für Length wurde ein ungültiger Wert angegeben. Dies ist ein Fehlercode.
STATUS_INSUFFICIENT_RESOURCES	FltSetVolumeInformation ist ein Poolzuordnungsfehler aufgetreten. Dies ist ein Fehlercode.
STATUS_INVALID_INFO_CLASS	Für FsInformationClass wurde 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.