Edit

Share via

SHRemoveLocalizedName function (shellapi.h)

  • Article

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

Syntax

SHSTDAPI SHRemoveLocalizedName(
  [in] PCWSTR pszPath
);

Parameters

[in] 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

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header shellapi.h
DLL Shell32.dll