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 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。