PathUndecorateW 函数 (shlwapi.h)

  • 项目

从路径字符串中删除修饰。

语法

void PathUndecorateW(
  [in, out] LPWSTR pszPath
);

参数

[in, out] pszPath

类型： LPTSTR

包含路径的长度为 null 的字符串MAX_PATH。 函数返回时， pszPath 指向未修饰的字符串。

返回值

无

备注

修饰由一对方括号组成，中间有一个或多个数字，紧接在基名后面和文件扩展名之前插入。

示例

下表说明了 PathUndecorate 如何修改字符串。

初始字符串 未修饰的字符串
C：\Path\File[5].txt C:\Path\File.txt
C：\Path\File[12] C：\Path\File
C:\Path\File.txt C:\Path\File.txt
C：\Path\[3].txt C：\Path\[3].txt
 

注意

shlwapi.h 标头将 PathUndecorate 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

要求 值
最低受支持的客户端 Windows 2000 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 shlwapi.h
Library Shlwapi.lib
DLL Shlwapi.dll (5.0 或更高版本)