Поделиться через

Функция SHSetLocalizedName (shellapi.h)

  • Статья

Задает локализованное имя файла в папке оболочки.

Синтаксис

SHSTDAPI SHSetLocalizedName(
  [in] PCWSTR pszPath,
  [in] PCWSTR pszResModule,
       int    idsRes
);

Параметры

[in] pszPath

Тип: PCWSTR

Указатель на строку, указывающую полный путь к целевому файлу.

[in] pszResModule

Тип: PCWSTR

Указатель на строковый ресурс, указывающий локализованную версию имени файла.

idsRes

Тип: int

Целочисленный идентификатор, указывающий локализованное имя файла в строковом ресурсе.

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

Тип: HRESULT

Если эта функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Если эта строка задана, Обозреватель отображает эту строку вместо имени файла. Путь к файлу не изменяется.

Приложения могут получить отображаемое (локализованное) имя с помощью IShellFolder::GetDisplayNameOf с флагом SIGDN_NORMALDISPLAY и синтаксического (нелокализованного) имени с помощью IShellItem::GetDisplayName с помощью флага SIGDN_DESKTOPABSOLUTEPARSING .

При вызове SHRemoveLocalizedName отображаемое имя будет идентично имени синтаксического анализа.

Требования

   
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header shellapi.h
DLL Shell32.dll; Shell32.dll (версия 5.6 или более поздняя)
Набор API ext-ms-win-shell-shell32-l1-2-0 (представлено в Windows 8.1)