共用方式為

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 true，否則會 傳回 false。

言論

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

注意

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

要求

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