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。

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

點 (。和。。) 慣例，例如 “..\“ 會解析相對於父目錄的路徑。
沒有斜線的名稱 (\\) —例如，“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 中，下列技術支援此函式。

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

注意

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