Função SHSetLocalizedName (shellapi.h)

Define o nome localizado de um arquivo em uma pasta shell.

Sintaxe

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

Parâmetros

[in] pszPath

Tipo: PCWSTR

Um ponteiro para uma cadeia de caracteres que especifica o caminho totalmente qualificado do arquivo de destino.

[in] pszResModule

Tipo: PCWSTR

Um ponteiro para um recurso de cadeia de caracteres que especifica a versão localizada do nome do arquivo.

idsRes

Tipo: int

Uma ID de inteiro que especifica o nome do arquivo localizado no recurso de cadeia de caracteres.

Valor retornado

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Quando essa cadeia de caracteres é definida, Explorer exibe essa cadeia de caracteres em vez do nome do arquivo. O caminho para o arquivo é inalterado.

Os aplicativos podem obter o nome de exibição (localizado) com IShellFolder::GetDisplayNameOf com o sinalizador SIGDN_NORMALDISPLAY e o nome da análise (não localizado) com IShellItem::GetDisplayName usando o sinalizador SIGDN_DESKTOPABSOLUTEPARSING .

Chamar SHRemoveLocalizedName torna o nome de exibição idêntico ao nome de análise.

Requisitos

Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shellapi.h
DLL	Shell32.dll; Shell32.dll (versão 5.6 ou posterior)
Conjunto de APIs	ext-ms-win-shell32-l1-2-0 (introduzido em Windows 8.1)