FltSetVolumeInformation, fonction (fltkernel.h)

Article
02/06/2025

FltSetVolumeInformation modifie différents types d’informations sur le volume auquel l’instance donnée est attachée.

Syntaxe

NTSTATUS FLTAPI FltSetVolumeInformation(
  [in]  PFLT_INSTANCE        Instance,
  [out] PIO_STATUS_BLOCK     Iosb,
  [out] PVOID                FsInformation,
  [in]  ULONG                Length,
  [in]  FS_INFORMATION_CLASS FsInformationClass
);

Paramètres

[in] Instance

Pointeur d’instance opaque pour une instance de pilote minifilter attachée au volume.

[out] Iosb

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

[out] FsInformation

Pointeur vers une mémoire tampon allouée par l’appelant contenant les valeurs à définir pour le volume. La structure des informations contenues dans la mémoire tampon est définie par le paramètre FsInformationClass.

[in] Length

Taille en octets de la mémoire tampon vers laquelle FsInformation pointe. L’appelant doit définir ce paramètre en fonction du FsInformationClassdonné. Par exemple, si la valeur de FsInformationClass est FileFsControlInformation, Length doit être au moins sizeof(FILE_FS_CONTROL_INFORMATION).

[in] FsInformationClass

Type d’informations à définir pour le volume. 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

FltSetVolumeInformation 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	FltSetVolumeInformation 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.
STATUS_INVALID_PARAMETER	L’instance est attachée à un volume réseau. FltSetVolumeInformation ne peut pas être utilisé pour définir des informations de volume réseau. Il s’agit d’un code d’erreur.