PathCchRenameExtension 函数 (pathcch.h)

  • 项目

将路径字符串末尾的文件名扩展名替换为新扩展名。 如果路径字符串未以扩展名结尾，则会添加新扩展。

此函数不同于 PathRenameExtension ，因为它接受前缀为“\”、“\？”和“\？\UNC”的路径。

注意 应使用此函数代替 PathRenameExtension ，以防止缓冲区溢出的可能性。

语法

WINPATHCCHAPI HRESULT PathCchRenameExtension(
  [in, out] PWSTR  pszPath,
  [in]      size_t cchPath,
  [in]      PCWSTR pszExt
);

参数

[in, out] pszPath

指向路径字符串的指针。 当此函数成功返回时，此值指向同一字符串，但具有重命名或添加的扩展名。

[in] cchPath

pszPath 指向的缓冲区的大小（以字符为单位）。

[in] pszExt

指向新扩展字符串的指针。 前导“.”字符是可选的。 如果为空字符串 (“”) ，将删除路径字符串中的任何现有扩展。

返回值

如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

要求

要求 值
最低受支持的客户端 Windows 8 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 [桌面应用 |UWP 应用]
目标平台 Windows
标头 pathcch.h
Library Pathcch.lib