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 專業版、Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 shlwapi.h
程式庫 Shlwapi.lib
Dll Shlwapi.dll (4.71 版或更新版本)