PathCchRemoveExtension 函数 (pathcch.h)

从路径中删除文件扩展名(如果存在)。

此函数与 PathRemoveExtension 的不同之处在于,它接受带有“\”、“\?”和“\?\UNC”前缀的路径。

注意此函数应用于代替 PathRemoveExtension ,以防止缓冲区溢出的可能性。

语法

WINPATHCCHAPI HRESULT PathCchRemoveExtension(
  [in, out] PWSTR  pszPath,
  [in]      size_t cchPath
);

参数

[in, out] pszPath

指向路径字符串的指针。 当此函数成功返回时,字符串将包含已删除任何扩展名的路径。 如果未找到扩展名,则字符串保持不变。

[in] cchPath

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

返回值

如果函数成功,则此函数返回 S_OK ;如果未找到扩展, 则返回S_FALSE ;否则返回错误代码。

要求

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