共用方式為

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

另請參閱

檔案管理功能

符號連結

交易式NTFS