通过

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 [仅限桌面应用]
目标平台 Windows
标头 shlwapi.h
Library Shlwapi.lib
DLL Shlwapi.dll (7.0 或更高版本)

另请参阅

PathMatchSpec