SHRemoveLocalizedName function

Removes the localized name of a file in a Shell folder.

Syntax

SHSTDAPI SHRemoveLocalizedName(
  PCWSTR pszPath
);

Parameters

pszPath

Type: PCWSTR

A pointer to a null-terminated, Unicode string that specifies the fully qualified path of the target file.

Return Value

Type: HRESULT

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

When a display name string is set by SHSetLocalizedName, Windows Explorer uses that string for display instead of the file name. The path to the file is unchanged.

Applications can use the IShellFolder::GetDisplayNameOf method to get the display (localized) name through with the SIGDN_NORMALDISPLAY flag and the parsing (non-localized) name with SIGDN_DESKTOPABSOLUTEPARSING.

Calling SHRemoveLocalizedName makes the display name identical to the parsing name.

Requirements

   
Windows version Windows Vista [desktop apps only] Windows Server 2008 [desktop apps only]
Target Platform Windows
Header shellapi.h
DLL Shell32.dll