通过

PathMatchSpecExA 函数 （shlwapi.h）

  • 项目

根据一个或多个文件名模式匹配路径中的文件名。

语法

LWSTDAPI PathMatchSpecExA(
  [in] LPCSTR pszFile,
  [in] LPCSTR pszSpec,
  [in] DWORD  dwFlags
);

参数

[in] pszFile

类型：LPCTSTR

指向以 null 结尾的字符串的指针，其中包含从中获取要匹配的文件名的路径。

[in] pszSpec

类型：LPCTSTR

指向包含要搜索的文件名模式的以 null 结尾的字符串的指针。 这可以是确切的名称，也可以包含通配符。 如果正好指定了一个模式，dwFlags中设置 PMSF_NORMAL 标志。 如果指定了多个模式，请用分号分隔它们，并设置 PMSF_MULTIPLE 标志。

[in] dwFlags

类型：DWORD

修改搜索条件。 以下是有效的标志。

PMSF_NORMAL （0x00000000）

pszSpec 参数指向要匹配的单个文件名模式。

PMSF_MULTIPLE（0x00000001）

pszSpec 参数指向要匹配的以分号分隔的文件名模式列表。

PMSF_DONT_STRIP_SPACES（0x00010000）

如果使用 PMSF_NORMAL，请不要忽略由 pszSpec指向的字符串中的前导空格。 如果使用 PMSF_MULTIPLE，请不要忽略由 pszSpec指向的字符串中包含的每个文件类型中的前导空格。 此标志可以与 PMSF_NORMAL 和 PMSF_MULTIPLE结合使用。

返回值

类型：HRESULT

返回以下值之一。

返回代码 描述
S_OK
 pszSpec 中指定的文件名模式 匹配 pszFile指向的字符串中找到的文件名。
S_FALSE
 pszSpec 中指定的文件名模式 与 pszFile指向的字符串中找到的文件名匹配。

言论

注意

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

要求

要求 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2008 [仅限桌面应用]
目标平台 窗户
标头 shlwapi.h
库 Shlwapi.lib
DLL Shlwapi.dll（版本 7.0 或更高版本）

另请参阅

PathMatchSpec