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