Fonction FltSetVolumeInformation (fltkernel.h)

Article
08/07/2023

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

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 de instance opaque pour un pilote de minifiltre instance attaché au volume.

[out] Iosb

Pointeur vers une structure de IO_STATUS_BLOCK qui reçoit le status d’achèvement final et des 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 pointe FsInformation . L’appelant doit définir ce paramètre en fonction de la FsInformationClass donnée. 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’un des éléments suivants.

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

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