Freigeben über


ZwSetVolumeInformationFile-Funktion (ntifs.h)

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)

Weitere Informationen

FILE_FS_CONTROL_INFORMATION

FILE_FS_LABEL_INFORMATION

FILE_FS_OBJECTID_INFORMATION

FltSetInformationFile

IRP_MJ_SET_VOLUME_INFORMATION

Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen

ZwQueryVolumeInformationFile

ZwSetInformationFile