Edit

FILE_FS_LABEL_INFORMATION structure (ntddk.h)

  • Article

The FILE_FS_LABEL_INFORMATION structure is used to set the label for a file system volume.

Syntax

typedef struct _FILE_FS_LABEL_INFORMATION {
  ULONG VolumeLabelLength;
  WCHAR VolumeLabel[1];
} FILE_FS_LABEL_INFORMATION, *PFILE_FS_LABEL_INFORMATION;

Members

VolumeLabelLength

Length, in bytes, of the name for the volume.

VolumeLabel[1]

Name for the volume.

Remarks

This information can be set in either of the following ways:

  • Call FltSetVolumeInformation or ZwSetVolumeInformationFile, passing FileFsLabelInformation as the value of FileInformationClass and passing a caller-allocated, FILE_FS_LABEL_INFORMATION-structured buffer as the value of FileInformation.
  • Create an IRP with major function code IRP_MJ_SET_VOLUME_INFORMATION.
FILE_WRITE_DATA access to the volume is required to set this information.

The size of the buffer passed in the FileInformation parameter to FltSetVolumeInformation or ZwSetVolumeInformationFile must be at least sizeof (FILE_FS_LABEL_INFORMATION).

This structure must be aligned on a LONG (4-byte) boundary.

Requirements

Requirement Value
Header ntddk.h (include Ntddk.h, Ntifs.h, Fltkernel.h)

See also

FltSetVolumeInformation

IRP_MJ_SET_VOLUME_INFORMATION

ZwSetVolumeInformationFile