SHSetLocalizedName-Funktion (shellapi.h)

Legt den lokalisierten Namen einer Datei in einem Shell-Ordner fest.

Syntax

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

Die 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 HRESULT-Fehlercode zurückgegeben.

Bemerkungen

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 analysierten (nicht lokalisierten) Namen mit IShellItem::GetDisplayName mithilfe des SIGDN_DESKTOPABSOLUTEPARSING-Flags abrufen.

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

Anforderungen

Anforderung	Wert
Mindestens unterstützter Client	Windows XP [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform	Fenster
Header	shellapi.h
Library	OneCore.Lib
DLL	Shell32.dll; Shell32.dll (Version 5.6 oder höher)
API-Satz	ext-ms-win-shell-shell32-l1-2-0 (eingeführt in Windows 8.1)