Share via

SHSetLocalizedName-Funktion (shellapi.h)

  • Artikel

Legt den lokalisierten Namen einer Datei in einem Shellordner fest.

Syntax

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

Parameter

[in] pszPath

Typ: PCWSTR

Ein Zeiger auf eine Zeichenfolge, die den vollqualifizierten Pfad der Zieldatei angibt.

[in] pszResModule

Typ: PCWSTR

Ein Zeiger auf eine Zeichenfolgenressource, die die lokalisierte Version des Dateinamens angibt.

idsRes

Typ: int

Eine ganzzahlige ID, die den lokalisierten Dateinamen in der Zeichenfolgenressource angibt.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn diese Zeichenfolge festgelegt ist, zeigt Explorer diese Zeichenfolge anstelle des Dateinamens an. Der Pfad zur Datei ist unverändert.

Anwendungen können den Anzeigenamen (lokalisiert) mit IShellFolder::GetDisplayNameOf mit dem SIGDN_NORMALDISPLAY-Flag und dem Analysenamen (nicht lokalisiert) mit IShellItem::GetDisplayName mithilfe des SIGDN_DESKTOPABSOLUTEPARSING-Flags abrufen.

Durch Aufrufen von SHRemoveLocalizedName wird der Anzeigename mit dem Analysenamen identisch.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shellapi.h
DLL Shell32.dll; Shell32.dll (Version 5.6 oder höher)
APIs ext-ms-win-shell-shell32-l1-2-0 (eingeführt in Windows 8.1)