setVolumeLabelA 函数 (winbase.h)

设置文件系统卷的标签。

语法

BOOL SetVolumeLabelA(
  [in, optional] LPCSTR lpRootPathName,
  [in, optional] LPCSTR lpVolumeName
);

[in, optional] lpRootPathName

指向包含卷驱动器号 (的字符串的指针，例如 X：) 或与卷 (关联的已装载文件夹的路径，例如 Y：\MountX) 。字符串必须以尾随反斜杠结尾， ('') 。如果此参数为 NULL，则使用当前目录的根目录。

[in, optional] lpVolumeName

指向包含卷的新标签的字符串的指针。如果此参数为 NULL，则该函数将从指定卷中删除任何现有标签，并且不分配新标签。

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。要获得更多的错误信息，请调用 GetLastError。

最大卷标签长度为 32 个字符。

FAT 文件系统： 最大卷标签长度为 11 个字符。

标签是用户为便于识别而分配给卷的用户友好名称。卷可以有标签、驱动器号，可以兼有两者或都没有。有关详细信息，请参阅命名卷。

在 Windows 8 和 Windows Server 2012 中，此函数由以下技术支持。

SMB 不支持卷管理功能。

注意

winbase.h 标头将 SetVolumeLabel 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。