CreateSymbolicLinkTransactedW 函数 (winbase.h)

[Microsoft强烈建议开发人员利用替代方法来实现应用程序的需求。 TxF 开发的许多方案可以通过更简单、更易用的技术来实现。 此外,TxF 在 Microsoft Windows 的未来版本中可能不可用。 有关详细信息,以及 TxF 的替代项,请参阅 使用事务 NTFS的替代项。]

创建符号链接作为事务处理操作。

语法

BOOLEAN CreateSymbolicLinkTransactedW(
  [in] LPCWSTR lpSymlinkFileName,
  [in] LPCWSTR 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”解析为“当前驱动器:\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 标头将 CreateSymbolicLinkTransacted 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2008 [仅限桌面应用]
目标平台 窗户
标头 winbase.h (包括 Windows.h)
Kernel32.lib
DLL Kernel32.dll

另请参阅

文件管理功能

符号链接

事务性 NTFS