ZwSetVolumeInformationFile-Funktion (ntifs.h)

Artikel
12/21/2024

Die ZwSetVolumeInformationFile Routine ändert Informationen über das Volume, das einer bestimmten Datei, einem Verzeichnis, einem Speichergerät oder einem Volume zugeordnet ist.

Syntax

NTSYSAPI NTSTATUS ZwSetVolumeInformationFile(
  [in]  HANDLE               FileHandle,
  [out] PIO_STATUS_BLOCK     IoStatusBlock,
  [in]  PVOID                FsInformation,
  [in]  ULONG                Length,
  [in]  FS_INFORMATION_CLASS FsInformationClass
);

Parameter

[in] FileHandle

Behandeln Sie ein Dateiobjekt für eine geöffnete Datei, ein Verzeichnis, ein Speichergerät oder ein Volume, dessen Volumeinformationen geändert werden sollen.

[out] IoStatusBlock

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

[in] FsInformation

Zeigen Sie auf einen vom Aufrufer zugewiesenen Puffer, der die zu ändernden Volumeinformationen enthält. Die Struktur der Informationen in diesem Puffer hängt vom Wert FsInformationClassab, wie in der folgenden Tabelle dargestellt.

[in] Length

Größe in Byte des Puffers, auf den FsInformationverweist. Der Aufrufer sollte diesen Parameter gemäß der angegebenen FsInformationClassfestlegen.

[in] FsInformationClass

Typ der festzulegenden Volumeinformationen. 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

ZwSetVolumeInformationFile gibt STATUS_SUCCESS oder einen geeigneten NTSTATUS-Wert wie einen der folgenden zurück:

Rückgabecode	Beschreibung
STATUS_INFO_LENGTH_MISMATCH	Für Lengthwurde ein ungültiger Wert angegeben. Dies ist ein Fehlercode.
STATUS_INSUFFICIENT_RESOURCES	ZwSetVolumeInformationFile ein Poolzuordnungsfehler aufgetreten ist. Dies ist ein Fehlercode.
STATUS_INVALID_INFO_CLASS	Für FsInformationClasswurde ein ungültiger Wert angegeben. Dies ist ein Fehlercode.

Bemerkungen

Rufen Sie zum Abfragen von Volumeninformationen ZwQueryVolumeInformationFileauf.

Um Informationen zu einer Datei zu ändern, rufen Sie ZwSetVolumeInformationFileauf.

Minifilter sollten FltSetInformationFile- anstelle von ZwSetVolumeInformationFile-verwenden.

Hinweis Wenn der Aufruf der ZwSetVolumeInformationFileFunktion im Benutzermodus auftritt, sollten Sie den Namen "NtSetInformationFile" anstelle von "ZwSetVolumeInformationFile" verwenden.

Bei Aufrufen von Kernelmodustreibern können sich die NtXxx und ZwXxx- Versionen einer Windows Native System Services-Routine anders verhalten, wie sie Eingabeparameter behandeln und interpretieren. Weitere Informationen zur Beziehung zwischen den NtXxx und ZwXxx- Versionen einer Routine finden Sie unter Using Nt and Zw Versions of the Native System Services Routines.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Server 2003
Zielplattform-	Universal
Header-	ntifs.h (einschließlich Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	PASSIVE_LEVEL
DDI-Complianceregeln	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)