Функция SetFileShortName устанавливает короткое имя заданного файла. Файл должен быть в томе NTFS.
Синтаксис
BOOL SetFileShortName( HANDLE hFile, LPCTSTR lpShortName ); |
Параметры
hFile
[in] Дескриптор файла. Файл, должен быть открытым или с правом доступа GENERIC_ALL или с GENERIC_WRITE|DELETE и с атрибутом файла FILE_FLAG_BACKUP_SEMANTICS.lpShortName
[in] Указатель на строку, которая определяет короткое имя файла.Возвращаемые значения
Если функция завершается успешно, возвращаемое значение - не нуль.
Если функция завершается ошибкой, величина возвращаемого значения - нуль. Чтобы получить дополнительные данные об ошибке, вызовите GetLastError. Функция GetLastError может возвратить один из нижеперечисленных кодов ошибок, которые являются конкретными для этой функции.
Код ошибки | Значение |
---|---|
ERROR_ALREADY_EXISTS | Определяемое короткое имя не уникально. |
ERROR_INVALID_PARAMETER | Или заданный файл уже был открыт в режиме чувствительном к регистру или заданное короткое имя - неправильное. |
Замечания
Вызывающая программа этой функции должна иметь привилегию SE_RESTORE_NAME . Для получения дополнительной информации, см. статью Запуск со специальными привилегиями.
Смотри также
Обзор Управление файлами, Функции, используемые в управлении файлами, GetShortPathName
Размещение и совместимость SetFileShortName |
||
К |
Windows XP |
Да |
л |
Windows 2000 |
Нет |
и |
Windows NT |
Нет |
е |
Windows Me |
Нет |
н |
Windows 98 |
Нет |
т |
Windows 95 |
Нет |
С |
Windows Server 2003 |
Да |
е | Windows 2000 Server | Нет |
р | Windows NT Server | Нет |
в | ||
е | ||
р | ||
Используемая библиотека |
Kernel32.lib |
|
Используемая DLL | - | |
Заголовочный файл | ||
- объявлено в |
Winbase.h |
|
- включено в |
Windows.h |
|
Unicode |
Реализуется как версии Unicode и ANSI. |
|
Замечания по платформе |
Не имеется |