PathCommonPrefixA 函式 (shlwapi.h)

  • 發行項

比較兩個路徑，以判斷它們是否共用通用前置詞。 前置詞是下列其中一種類型：「C：\」、「.」、「.」、「.」、「.」。\".

語法

int PathCommonPrefixA(
  [in]            LPCSTR pszFile1,
  [in]            LPCSTR pszFile2,
  [out, optional] LPSTR  achPath
);

參數

[in] pszFile1

類型： LPCTSTR

長度為 null 的字串指標，MAX_PATH包含第一個路徑名稱。

[in] pszFile2

類型： LPCTSTR

長度為 null 的字串指標，MAX_PATH包含第二個路徑名稱。

[out, optional] achPath

類型： LPTSTR

接收通用前置詞之緩衝區的指標。 此緩衝區的大小必須至少MAX_PATH個字元。 如果沒有常見的前置詞，則會設定為 Null。

傳回值

類型： int

傳回路徑中通用前置字元的計數。 如果輸出緩衝區指標不是 Null，則會將這些字元複製到輸出緩衝區。

備註

注意

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

規格需求

   
最低支援的用戶端 Windows 2000 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平臺 Windows
標頭 shlwapi.h
程式庫 Shlwapi.lib
DLL Shlwapi.dll (4.71 版或更新版本)