Функция 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. |
|
| Замечания по платформе |
Не имеется |
|