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。

言論

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

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

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

科技	支援
伺服器消息塊（SMB） 3.0 通訊協定	不
SMB 3.0 透明故障轉移（TFO）	不
具有向外延展檔案共用的SMB 3.0（SO）	不
叢集共用磁碟區檔案系統（CsvFS）	不
復原檔案系統（ReFS）	不

SMB 3.0 不支援 TxF。

注意

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

要求

要求	價值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
支援的最低伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平臺	窗戶
標頭	winbase.h （包括 Windows.h）
連結庫	Kernel32.lib
DLL	Kernel32.dll