Функция CreateSymbolicLinkTransactedW (winbase.h)

Статья
03/03/2024

[Корпорация Майкрософт настоятельно рекомендует разработчикам использовать альтернативные средства для удовлетворения потребностей вашего приложения. Многие сценарии, для которые был разработан 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" разрешается в "current drive:\Windows\System32".
Текущий рабочий каталог — относительный. Например, если текущим рабочим каталогом является C:\Windows\System32, "C:File.txt" разрешается в "C:\Windows\System32\File.txt".
Примечание Если указать относительную связь текущего рабочего каталога, она создается как абсолютная связь из-за того, как текущий рабочий каталог обрабатывается на основе пользователя и потока.

В Windows 8 и Windows Server 2012 эта функция поддерживается следующими технологиями.

Технология	Поддерживается
Протокол SMB 3.0	Нет
Прозрачная отработка отказа (TFO) SMB 3.0	Нет
SMB 3.0 с масштабируемыми общими папками (SO)	Нет
Файловая система общего тома кластера (CSVFS)	Нет
Восстанавливаемая файловая система (ReFS)	Нет

SMB 3.0 не поддерживает TxF.

Примечание

Заголовок winbase.h определяет CreateSymbolicLinkTransacted в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	winbase.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll

См. также

Функции управления файлами

Символические ссылки

Поддержка транзакций в NTFS