PathCompactPathExA 関数 (shlwapi.h)

パス コンポーネントを省略記号に置き換えて、特定の文字数内に収まるようにパスを切り捨てます。

構文

BOOL PathCompactPathExA(
  [out] LPSTR  pszOut,
  [in]  LPCSTR pszSrc,
  [in]  UINT   cchMax,
  [in]  DWORD  dwFlags
);

パラメーター

[out] pszOut

種類: LPTSTR

変更された文字列のアドレス。

[in] pszSrc

型: LPCTSTR

変更するパスを含む長さMAX_PATHの null で終わる文字列へのポインター。

[in] cchMax

型: UINT

新しい文字列に含まれる最大文字数 (終端の null 文字を含む)。 たとえば、 cchMax = 8 の場合、結果の文字列には最大 7 文字と終端の null 文字を含めることができます。

[in] dwFlags

型: DWORD

戻り値

種類: BOOL

成功した場合は TRUE 、それ以外の場合 は FALSE を 返します。

注釈

元の文字列で使用されている場合は、'/' 区切り記号が '' の代わりに使用されます。 pszSrc がパスの代わりに長すぎるファイル名を指している場合、省略記号や終端の NULL 文字を含め、ファイル名は cchMax 文字に切り捨てられます。 たとえば、入力ファイル名が "My Filename" で cchMax が 10 の場合、 PathCompactPathEx は "My Fil..."を返します。

注意

shlwapi.h ヘッダーは PathCompactPathEx をエイリアスとして定義します。このエイリアスは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shlwapi.h
Library	Shlwapi.lib
[DLL]	Shlwapi.dll (バージョン 4.71 以降)