PathCompactPathExW 函式 (shlwapi.h)

藉由以省略號取代路徑元件，截斷路徑以符合特定數目的字元。

語法

BOOL PathCompactPathExW(
  [out] LPWSTR  pszOut,
  [in]  LPCWSTR pszSrc,
  [in]  UINT    cchMax,
  [in]  DWORD   dwFlags
);

參數

[out] pszOut

類型： LPTSTR

已改變之字串的位址。

[in] pszSrc

類型： LPCTSTR

長度為 null 之字串的指標，MAX_PATH包含要改變的路徑。

[in] cchMax

類型： UINT

要包含在新字串中的字元數上限，包括終止的 Null 字元。 例如，如果 cchMax = 8，產生的字串最多可以包含 7 個字元加上終止 Null 字元。

[in] dwFlags

類型： DWORD

傳回值

類型： BOOL

如果成功，則傳回 TRUE ，否則傳回 FALSE 。

備註

如果原始字串使用它，則會使用 『/』 分隔符，而不是 『\』。 如果 pszSrc 指向太長的檔名，而不是路徑，檔名將會截斷為 cchMax 字元，包括省略號和終止 NULL 字元。 例如，如果輸入檔名為 「My Filename」 且 cchMax 為 10，PathCompactPathEx 會傳回 “My Fil...”。

注意

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

規格需求

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