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

Tipo: HRESULT

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

Observações

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

Os aplicativos podem obter o nome de exibição (localizado) com IShellFolder::GetDisplayNameOf com o sinalizador SIGDN_NORMALDISPLAY e o nome de 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.

Requirements