createSymbolicLinkTransactedA 函式 (winbase.h)

  • 發行項

[Microsoft 強烈建議開發人員利用替代方法來達成應用程式的需求。 許多針對 TxF 開發的案例，都可以透過更簡單且更容易取得的技術來達成。 此外，未來版本的 Microsoft Windows 可能無法使用 TxF。 如需詳細資訊，以及 TxF 的替代方案，請參閱 使用交易式 NTFS 的替代方案。]

建立符號連結做為交易作業。

語法

BOOLEAN CreateSymbolicLinkTransactedA(
  [in] LPCSTR lpSymlinkFileName,
  [in] LPCSTR lpTargetFileName,
  [in] DWORD  dwFlags,
  [in] HANDLE hTransaction
);

參數

[in] lpSymlinkFileName

要建立的符號連結。

[in] lpTargetFileName

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

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

[in] dwFlags

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

值 意義
0x0
 鏈接目標是檔案。
SYMBOLIC_LINK_FLAG_DIRECTORY
0x1
 鏈接目標是目錄。

[in] hTransaction

交易的句柄。 CreateTransaction 函式會傳回此句柄。

傳回值

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

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

備註

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

  • 點 (。和。。) 慣例，例如 “..\“ 會解析相對於父目錄的路徑。
  • 沒有斜線的名稱 (\\) —例如，“tmp” 會解析相對於目前目錄的路徑。
  • 根相對-例如，“\Windows\System32” 解析為 “current drive：\Windows\System32”。
  • 目前的工作目錄相對—例如，如果目前的工作目錄是 C：\Windows\System32，“C:File.txt” 會解析為 “C:\Windows\System32\File.txt”。
    注意 如果您指定目前的工作目錄相對連結，則會建立為絕對連結，因為根據使用者和線程處理目前工作目錄的方式。
     
在 Windows 8 和 Windows Server 2012 中，下列技術支援此函式。
技術 支援
伺服器消息塊 (SMB) 3.0 通訊協定 No
SMB 3.0 透明故障轉移 (TFO) No
具有向外延展檔案共用的SMB 3.0 (SO) No
叢集共用磁碟區文件系統 (CsvFS) No
彈性檔案系統 (ReFS) No
 

SMB 3.0 不支援 TxF。

注意

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

規格需求

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

另請參閱

檔案管理功能

符號連結

交易式 NTFS