共用方式為


createSymbolicLinkA 函式 (winbase.h)

建立符號連結。

若要以交易作業的形式執行此作業,請使用 CreateSymbolicLinkTransacted 函式

語法

BOOLEAN CreateSymbolicLinkA(
  [in] LPCSTR lpSymlinkFileName,
  [in] LPCSTR lpTargetFileName,
  [in] DWORD  dwFlags
);

參數

[in] lpSymlinkFileName

要建立的符號連結。

此參數可能包含路徑。

根據預設,名稱限製為MAX_PATH個字元。 若要將此限制延伸至 32,767 寬字元,請在路徑前面加上 “\\?\”。 如需詳細資訊,請參閱命名檔案、路徑與命名空間

提示

從 Windows 10 版本 1607 開始,您可以選擇移除MAX_PATH限制,而不需在前面加上 “\\?\”。 如需詳細資訊,請參閱 命名檔案、路徑和命名空間 的一節。

[in] lpTargetFileName

要建立之符號鏈接的目標名稱。

如果 lpTargetFileName 有與其相關聯的裝置名稱,則會將連結視為絕對連結;否則,鏈接會被視為相對連結。

此參數可能包含路徑。

根據預設,名稱限製為MAX_PATH個字元。 若要將此限制延伸至 32,767 寬字元,請在路徑前面加上 “\\?\”。 如需詳細資訊,請參閱命名檔案、路徑與命名空間

提示

從 Windows 10 版本 1607 開始,您可以選擇移除MAX_PATH限制,而不需在前面加上 “\\?\”。 如需詳細資訊,請參閱 命名檔案、路徑和命名空間 的一節。

[in] dwFlags

指出連結目標 lpTargetFileName 是否為目錄。

意義
0x0
鏈接目標是檔案。
SYMBOLIC_LINK_FLAG_DIRECTORY
0x1
鏈接目標是目錄。
SYMBOLIC_LINK_FLAG_ALLOW_UNPRIVILEGED_CREATE
0x2
指定這個旗標,以允許在進程未提高許可權時建立符號連結。 在UWP中,必須先在電腦上啟用 開發人員模式 ,此選項才能運作。 在 MSIX 下,不需要為此旗標啟用開發人員模式。

傳回值

如果函式成功,則傳回非零的值。

如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError

備註

符號連結可以是絕對連結或相對連結。 絕對連結是指定路徑名稱每個部分的連結;相對連結會決定相對於相對連結規範位於指定路徑的位置。 相對連結是使用下列慣例來指定:

  • 點 (。和。。) 慣例,例如 “..\“ 會解析相對於父目錄的路徑。
  • 沒有斜線的名稱 (\\) —例如,“tmp” 會解析相對於目前目錄的路徑。
  • 根相對-例如,“\Windows\System32” 解析為 “current drive:\Windows\System32”。
  • 目前的工作目錄相對—例如,如果目前的工作目錄是 C:\Windows\System32,“C:File.txt” 會解析為 “C:\Windows\System32\File.txt”。
    注意 如果您指定目前的工作目錄相對連結,則會建立為絕對連結,因為根據使用者和線程處理目前工作目錄的方式。
     
若要移除符號連結,請使用 DeleteFile 或類似 API 刪除檔案 () ,或使用 RemoveDirectory 或類似的 API 移除目錄 (,視使用的符號連結類型而定) 。

在 Windows 8 和 Windows Server 2012 中,下列技術支援此函式。

技術 支援
伺服器消息塊 (SMB) 3.0 通訊協定 Yes
SMB 3.0 透明故障轉移 (TFO) Yes
具有向外延展檔案共用的SMB 3.0 (SO) No
叢集共用磁碟區文件系統 (CsvFS) No
彈性檔案系統 (ReFS) Yes
 

CsvF 不支援軟連結或任何其他重新分析點。

注意

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

規格需求

需求
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 winbase.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

CreateSymbolicLinkTransacted

檔案管理功能

符號連結