Fonction ZwSetVolumeInformationFile (ntifs.h)

Article
03/05/2024

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

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, un répertoire, un périphérique de stockage ou un volume ouvert dont les informations de volume doivent être modifiées.

[out] IoStatusBlock

Pointeur vers une structure de IO_STATUS_BLOCK qui reçoit le status d’achèvement final et des informations sur l’opération.

[in] FsInformation

Pointeur vers une mémoire tampon allouée à 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 vers FsInformation. L’appelant doit définir ce paramètre en fonction de la FsInformationClass donnée.

[in] FsInformationClass

Type d’informations de volume à définir. Celui-ci peut avoir l'une des valeurs suivantes :

Value	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 retournée

ZwSetVolumeInformationFile retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, par exemple :

Code de retour	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 les informations de volume, appelez ZwQueryVolumeInformationFile.

Pour modifier les informations relatives à un fichier, appelez ZwSetVolumeInformationFile.

Les minifiltres doivent utiliser FltSetInformationFile au lieu de ZwSetVolumeInformationFile.

Note 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 dans 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 Utilisation des versions Nt et Zw des routines des services système natifs.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Server 2003
Plateforme cible	Universal
En-tête	ntifs.h (inclure Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Règles de conformité DDI	HwStorPortProhibitedDDIs(storport),PowerIrpDDis(wdm)