共用方式為

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 標頭會根據 UNICODE 預處理器常數的定義，將 PathMatchSpecEx 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 shlwapi.h
連結庫 Shlwapi.lib
DLL Shlwapi.dll （7.0 版或更新版本）

另請參閱

PathMatchSpec