Condividi tramite

Funzione SHSetLocalizedName (shellapi.h)

  • Articolo

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 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 .

Commenti

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 di analisi.

Requisiti

   
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shellapi.h
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)