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

Статья
11/20/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.

Замечания

Символьные ссылки могут быть абсолютными или относительными. Абсолютные ссылки — это ссылки, указывающие каждую часть имени пути; относительные ссылки определяются относительно того, где описатели относительной связи находятся в указанном пути. Относительные ссылки указываются с помощью следующих соглашений:

Соглашения 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 определяет CreateSymbolicLinkTransacted как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2008 [только классические приложения]
целевая платформа	Виндоус
заголовка	winbase.h (включая Windows.h)
библиотеки	Kernel32.lib
DLL	Kernel32.dll

См. также

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

символьные ссылки

транзакционных NTFS

Поделиться через