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