Установить метку тома файловой системы

Delphi , Файловая система , Файлы

BOOL SetVolumeLabel(
    LPCTSTR lpRootPathName,     // адрес имени корневой директории тома
    LPCTSTR lpVolumeName        // метка тома
   );

Параметры

lpRootPathName – указывает на завершающуюся нулем строку, определяющую корневую директорию тома файловой системы, метка которого будет устанавливаться. Если значение этого параметра равно NULL, используется корень текущей директории.

lpVolumeName – указывает на строку, определяющую метку тома. Если значение этого параметра равно NULL, то функция удаляет метку указанного тома.

Возвращаемые значения

В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError.

См. также: GetVolumeInformation.

Функция SetVolumeLabel устанавливает или удаляет метку тома для файловой системы. Метка тома - это строка, которая идентифицирует том и может использоваться для отображения имени тома в приложениях управления файлами, таких как Windows Explorer.

Сигнатура функции

BOOL SetVolumeLabel(
    LPCTSTR lpRootPathName,       // адрес null-терминированной строки, указывающей на корневой каталог тома
    LPCTSTR lpVolumeName          // новая метка тома
);

Параметры

• lpRootPathName: указатель на null-терминированную строку, которая specifies корневой каталог тома. Если этот параметр равен NULL, будет использоваться текущий рабочий каталог.
• lpVolumeName: указатель на строку, которая specifies новую метку тома. Если этот параметр равен NULL, существующая метка тома будет удалена.

Возвращаемое значение

• Если функция успешна, она возвращает ненул-значение (TRUE).
• Если функция неудачна, она возвращает нулевое значение (FALSE). Для получения дополнительной информации о ошибке вызовите функцию GetLastError.

Описание Функция SetVolumeLabel устанавливает или удаляет метку тома для файловой системы. Метка тома - это строка, которая идентифицирует том и может использоваться для отображения имени тома в приложениях управления файлами.

См. также

• GetVolumeInformation: функция, которая получает информацию о файловой системе, включая ее метку тома.

Функция SetVolumeLabel устанавливает метку тома файловой системы, указывая на корневую директорию тома и метку, а возвращает ненулевое значение при успехе или нуль при неудаче.

Комментарии и вопросы

Получайте свежие новости и обновления по Object Pascal, Delphi и Lazarus прямо в свой смартфон. Подпишитесь на наш Telegram-канал delphi_kansoftware и будьте в курсе последних тенденций в разработке под Linux, Windows, Android и iOS

:: Главная :: Файлы ::