ZwSetVolumeInformationFile, fonction (ntifs.h)

Article
12/21/2024

La routine ZwSetVolumeInformationFile modifie les informations sur le volume associé à un fichier, un répertoire, un périphérique de stockage ou un volume donnés.

Syntaxe

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

Paramètres

[in] FileHandle

Gérez un objet de fichier pour un fichier ouvert, un répertoire, un appareil de stockage ou un volume dont les informations de volume doivent être modifiées.

[out] IoStatusBlock

Pointeur vers une structure IO_STATUS_BLOCK qui reçoit l’état d’achèvement final et les informations relatives à l’opération.

[in] FsInformation

Pointeur vers une mémoire tampon allouée par l’appelant contenant les informations de volume à modifier. La structure des informations contenues dans cette mémoire tampon dépend de la valeur de FsInformationClass, comme indiqué dans le tableau suivant.

[in] Length

Taille en octets de la mémoire tampon pointée par FsInformation. L’appelant doit définir ce paramètre en fonction du FsInformationClassdonné.

[in] FsInformationClass

Type d’informations de volume à définir. L’une des opérations suivantes :

Valeur	Signification
FileFsControlInformation	Définissez FILE_FS_CONTROL_INFORMATION pour le volume.
FileFsLabelInformation	Définissez FILE_FS_LABEL_INFORMATION pour le volume.
FileFsObjectIdInformation	Définissez FILE_FS_OBJECTID_INFORMATION pour le volume.

Valeur de retour

ZwSetVolumeInformationFile retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, comme l’une des valeurs suivantes :

Retourner le code	Description
STATUS_INFO_LENGTH_MISMATCH	Une valeur non valide a été spécifiée pour Length. Il s’agit d’un code d’erreur.
STATUS_INSUFFICIENT_RESOURCES	ZwSetVolumeInformationFile a rencontré un échec d’allocation de pool. Il s’agit d’un code d’erreur.
STATUS_INVALID_INFO_CLASS	Une valeur non valide a été spécifiée pour FsInformationClass. Il s’agit d’un code d’erreur.

Remarques

Pour interroger des informations sur le volume, appelez ZwQueryVolumeInformationFile.

Pour modifier des informations sur un fichier, appelez ZwSetVolumeInformationFile.

Les minifilters doivent utiliser FltSetInformationFile au lieu de ZwSetVolumeInformationFile.

Remarque Si l’appel à la fonction ZwSetVolumeInformationFilese produit en mode utilisateur, vous devez utiliser le nom «NtSetInformationFile» au lieu de «ZwSetVolumeInformationFile».

Pour les appels à partir de pilotes en mode noyau, les versions NtXxx et ZwXxx d’une routine Windows Native System Services peuvent se comporter différemment de la façon dont elles gèrent et interprètent les paramètres d’entrée. Pour plus d’informations sur la relation entre les versions NtXxx et ZwXxx d’une routine, consultez Using Nt and Zw Versions of the Native System Services Routines.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Server 2003
plateforme cible	Universel
d’en-tête	ntifs.h (include Ntifs.h)
bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
règles de conformité DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)