PathFindSuffixArrayW 函式 (shlwapi.h)

判斷指定的檔名是否有其中一個後綴清單。

語法

LPCWSTR PathFindSuffixArrayW(
  [in] LPCWSTR       pszPath,
  [in] const LPCWSTR *apszSuffix,
  [in] int           iArraySize
);

參數

[in] pszPath

類型: LPCTSTR

長度上限之 null 終止字串的指標,MAX_PATH包含要測試的檔名。 可以使用完整路徑。

[in] apszSuffix

類型: const LPCTSTR*

iArraySize 字串指標的陣列。 指向的每個字串都是以 Null 結尾,並包含一個後綴。 字串可以是可變長度。

[in] iArraySize

類型: int

apszSuffix 所指向之陣列中的項目數目。

傳回值

類型: LPCTSTR

如果成功,則會傳回字串的指標,如果 pszPath 未以其中一個指定的後綴結尾,則傳回 NULL

備註

此函式會使用區分大小寫的比較。 後綴必須完全符合。

注意

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

規格需求

需求
最低支援的用戶端 Windows 2000 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 shlwapi.h
程式庫 Shlwapi.lib
Dll Shlwapi.dll (5.0 版或更新版本)