Funzione SHSetLocalizedName (shellapi.h)

Imposta il nome localizzato di un file in una cartella shell.

Sintassi

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

Parametri

[in] pszPath

Tipo: PCWSTR

Puntatore a una stringa che specifica il percorso completo del file di destinazione.

[in] pszResModule

Tipo: PCWSTR

Puntatore a una risorsa stringa che specifica la versione localizzata del nome file.

idsRes

Tipo: int

ID intero che specifica il nome del file localizzato nella risorsa stringa.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Osservazioni:

Quando questa stringa è impostata, Esplora risorse visualizza questa stringa anziché il nome del file. Il percorso del file rimane invariato.

Le applicazioni possono ottenere il nome visualizzato (localizzato) con IShellFolder::GetDisplayNameOf con il flag SIGDN_NORMALDISPLAY e il nome di analisi (non localizzato) con IShellItem::GetDisplayName usando il flag SIGDN_DESKTOPABSOLUTEPARSING .

La chiamata a SHRemoveLocalizedName rende il nome visualizzato identico al nome dell'analisi.

Requisiti

Requisito	Value
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Header	shellapi.h
Library	OneCore.Lib
DLL	Shell32.dll; Shell32.dll (versione 5.6 o successiva)
Set di API	ext-ms-win-shell-shell32-l1-2-0 (introdotto in Windows 8.1)