Функция 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 [только классические приложения]
целевая платформа	Виндоус
Header	shellapi.h
Library	OneCore.Lib
DLL	Shell32.dll; Shell32.dll (версия 5.6 или более поздняя)
Набор API	ext-ms-win-shell-shell32-l1-2-0 (представлено в Windows 8.1)