ZwSetVolumeInformationFile-Funktion (ntifs.h)

Artikel
03/08/2023

Die ZwSetVolumeInformationFile-Routine ändert Informationen über das Volume, das einer bestimmten Datei, einem bestimmten Verzeichnis, einem bestimmten Speichergerät oder 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

Verarbeiten eines Dateiobjekts für eine geöffnete Datei, ein Verzeichnis, ein Speichergerät oder ein Volume, dessen Volumeinformationen geändert werden sollen.

[out] IoStatusBlock

Zeiger auf eine IO_STATUS_BLOCK-Struktur, die den endgültigen Abschluss status und Informationen zum Vorgang empfängt.

[in] FsInformation

Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der die zu ändernden Volumeinformationen enthält. Die Struktur der Informationen in diesem Puffer hängt vom Wert von FsInformationClass ab, wie in der folgenden Tabelle gezeigt.

[in] Length

Größe des Puffers in Byte, auf den fsInformation verweist. Der Aufrufer sollte diesen Parameter entsprechend der angegebenen FsInformationClass festlegen.

[in] FsInformationClass

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

Hinweise

Rufen Sie ZwQueryVolumeInformationFile auf, um Volumeinformationen abzufragen.

Um Informationen zu einer Datei zu ändern, rufen Sie ZwSetVolumeInformationFile auf.

Minifilter sollten FltSetInformationFile anstelle von ZwSetVolumeInformationFile verwenden.

Hinweis Wenn der Aufruf der ZwSetVolumeInformationFile-Funktionim Benutzermodus erfolgt, 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 verarbeiten und interpretieren. Weitere Informationen zur Beziehung zwischen den Nt Xxx- und ZwXxx-Versionen einer Routine finden Sie unter Verwenden von Nt- und Zw-Versionen der systemeigenen Systemdienstroutinen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Server 2003
Zielplattform	Universell
Header	ntifs.h (include Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)