Функция SetFileShortName

Функция 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.

 Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz