Funzione ZwSetVolumeInformationFile (ntifs.h)

Articolo
12/21/2024

La routine ZwSetVolumeInformationFile modifica le informazioni sul volume associato a un determinato file, directory, dispositivo di archiviazione o volume.

Sintassi

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

Parametri

[in] FileHandle

Handle in un oggetto file per un file aperto, una directory, un dispositivo di archiviazione o un volume le cui informazioni sul volume devono essere modificate.

[out] IoStatusBlock

Puntatore a una struttura IO_STATUS_BLOCK che riceve lo stato di completamento finale e informazioni sull'operazione.

[in] FsInformation

Puntatore a un buffer allocato dal chiamante contenente le informazioni sul volume da modificare. La struttura delle informazioni in questo buffer dipende dal valore di FsInformationClass, come illustrato nella tabella seguente.

[in] Length

Dimensioni in byte del buffer a cui punta FsInformation. Il chiamante deve impostare questo parametro in base all'FsInformationClass.

[in] FsInformationClass

Tipo di informazioni sul volume da impostare. Uno dei seguenti:

Valore	Significato
FileFsControlInformation	Impostare FILE_FS_CONTROL_INFORMATION per il volume.
FileFsLabelInformation	Impostare FILE_FS_LABEL_INFORMATION per il volume.
FileFsObjectIdInformation	Impostare FILE_FS_OBJECTID_INFORMATION per il volume.

Valore restituito

ZwSetVolumeInformationFile restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio uno dei seguenti:

Codice restituito	Descrizione
STATUS_INFO_LENGTH_MISMATCH	È stato specificato un valore non valido per Length. Si tratta di un codice di errore.
STATUS_INSUFFICIENT_RESOURCES	ZwSetVolumeInformationFile rilevato un errore di allocazione del pool. Si tratta di un codice di errore.
STATUS_INVALID_INFO_CLASS	È stato specificato un valore non valido per FsInformationClass. Si tratta di un codice di errore.

Osservazioni

Per eseguire query sulle informazioni sul volume, chiamare ZwQueryVolumeInformationFile.

Per modificare le informazioni su un file, chiamare ZwSetVolumeInformationFile.

I minifiltri devono usare FltSetInformationFile anziché ZwSetVolumeInformationFile.

Nota Se la chiamata alla funzione ZwSetVolumeInformationFilesi verifica in modalità utente, è consigliabile usare il nome "NtSetInformationFile" anziché "ZwSetVolumeInformationFile".

Per le chiamate da driver in modalità kernel, le NtXxx e ZwXxx versioni di una routine di Windows Native System Services possono comportarsi in modo diverso nel modo in cui gestiscono e interpretano i parametri di input. Per altre informazioni sulla relazione tra le versioni NtXxx e ZwXxx di una routine, vedere Using Nt and Zw Versions of the Native System Services Routines.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Server 2003
piattaforma di destinazione	Universale
intestazione	ntifs.h (include Ntifs.h)
libreria	NtosKrnl.lib
dll	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
regole di conformità DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)