PathCompactPathExA 函式 (shlwapi.h)

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

語法

BOOL PathCompactPathExA(
  [out] LPSTR  pszOut,
  [in]  LPCSTR 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...”。

規格需求