PathCchFindExtension 函数 (pathcch.h)

  • 项目

搜索路径以查找其文件扩展名，例如“.exe”或“.ini”。 此函数不搜索特定扩展;它搜索是否存在任何扩展。

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

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

语法

WINPATHCCHAPI HRESULT PathCchFindExtension(
  [in]  PCWSTR pszPath,
  [in]  size_t cchPath,
  [out] PCWSTR *ppszExt
);

参数

[in] pszPath

指向要搜索的路径的指针。

[in] cchPath

pszPath 指向的缓冲区的大小（以字符为单位），包括 null 终止符。

[out] ppszExt

当此函数成功返回时，指针的地址指向 pszPath 中扩展前面的“.”字符。 如果未找到扩展名，则指向字符串的终止 null 字符。

返回值

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

要求

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