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 有與其相關聯的裝置名稱，則會將連結視為絕對連結;否則，鏈接會被視為相對連結。

此參數可能包含路徑。

提示

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

[in] dwFlags

指出鏈接目標 lpTargetFileName是否為目錄。

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

如果函式成功，則傳回值為非零值。

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

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

Dot （. 和 ..）慣例，例如 “..\“ 會解析相對於父目錄的路徑。
沒有斜線的名稱（\\）—例如，“tmp” 會解析相對於目前目錄的路徑。
根相對 -- 例如，“\Windows\System32” 解析為 “目前的磁碟驅動器：\Windows\System32”。
目前的工作目錄相對 —例如，如果目前的工作目錄是 C：\Windows\System32，“C:File.txt”解析為 “C:\Windows\System32\File.txt”。
注意如果您指定目前的工作目錄相對連結，則會建立為絕對連結，因為目前的工作目錄是根據使用者和線程處理的方式。

若要移除符號連結，請刪除檔案（使用 DeleteFile 或類似 API）或移除目錄（使用 RemoveDirectory 或類似 API），視使用何種符號連結類型而定。

在 Windows 8 和 Windows Server 2012 中，下列技術支援此功能。

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

注意

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