Funzione ZwSetVolumeInformationFile (ntifs.h)

Articolo
08/07/2023

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

Gestire 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'oggetto FsInformationClass specificato.

[in] FsInformationClass

Tipo di informazioni sul volume da impostare. I tipi validi sono:

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 ha 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.

Commenti

Per eseguire query sulle informazioni sul volume, chiamare ZwQueryVolumeInformationFile.

Per modificare le informazioni su un file, chiama ZwSetVolumeInformationFile.

I minifiltri devono usare FltSetInformationFile anziché ZwSetVolumeInformationFile.

Nota Se la chiamata alla funzione ZwSetVolumeInformationFileviene eseguita in modalità utente, devi usare il nome "NtSetInformationFile" anziché "ZwSetVolumeInformationFile".

Per le chiamate da driver in modalità kernel, le versioni NtXxx e ZwXxx di una routine di Servizi di sistema nativi di Windows 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 .For more information about the Nt Xxx and Zw versions of the Native System Services Routines.

Requisiti

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)