FILE_FS_LABEL_INFORMATION structure

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

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

Header

Ntddk.h (include Ntddk.h, Ntifs.h, or Fltkernel.h)

See also

FltSetVolumeInformation
IRP_MJ_SET_VOLUME_INFORMATION
ZwSetVolumeInformationFile

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft