PathCompactPathExW 関数 (shlwapi.h)

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

構文

BOOL PathCompactPathExW(
  [out] LPWSTR  pszOut,
  [in]  LPCWSTR 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 バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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