PathCommonPrefixW 関数 (shlwapi.h)

  • [アーティクル]

2 つのパスを比較して、共通のプレフィックスを共有しているかどうかを判断します。 プレフィックスは、"C:\"、"."、".."、".のいずれかの種類です。\".

構文

int PathCommonPrefixW(
  [in]            LPCWSTR pszFile1,
  [in]            LPCWSTR pszFile2,
  [out, optional] LPWSTR  achPath
);

パラメーター

[in] pszFile1

型: LPCTSTR

最初のパス名を含む長MAX_PATHの null で終わる文字列へのポインター。

[in] pszFile2

型: LPCTSTR

2 番目のパス名を含む長MAX_PATHの null で終わる文字列へのポインター。

[out, optional] achPath

種類: LPTSTR

共通プレフィックスを受け取るバッファーへのポインター。 このバッファーのサイズは、少なくともMAX_PATH文字である必要があります。 共通プレフィックスがない場合は、 NULL に設定されます。

戻り値

型: int

パス内の一般的なプレフィックス文字の数を返します。 出力バッファー ポインターが NULL でない場合、これらの文字は出力バッファーにコピーされます。

注釈

注意

shlwapi.h ヘッダーは PathCommonPrefix をエイリアスとして定義します。このエイリアスは、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 以降)