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

Статья
08/27/2023

[Корпорация Майкрософт настоятельно рекомендует разработчикам использовать альтернативные средства для удовлетворения потребностей вашего приложения. Многие сценарии, для работы с которыми был разработан TxF, можно реализовать с помощью более простых и доступных методов. Кроме того, TxF может быть недоступен в будущих версиях Microsoft Windows. Дополнительные сведения и альтернативы TxF см. в разделе Альтернативы использованию транзакционной NTFS.]

Создает перечисление всех жестких ссылок на указанный файл как транзакционные операции. Функция возвращает дескриптор перечисления, который можно использовать при последующих вызовах функции FindNextFileNameW .

Синтаксис

HANDLE FindFirstFileNameTransactedW(
  [in]           LPCWSTR lpFileName,
  [in]           DWORD   dwFlags,
  [in, out]      LPDWORD StringLength,
  [in, out]      PWSTR   LinkName,
  [in, optional] HANDLE  hTransaction
);

Параметры

[in] lpFileName

Имя файла.

Файл должен находиться на локальном компьютере; В противном случае функция завершается сбоем, и для последнего кода ошибки задано значение ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE (6805).

[in] dwFlags

Защищены; укажите ноль (0).

[in, out] StringLength

Размер буфера, на который указывает параметр LinkName , в символах. Если этот вызов завершается сбоем и ошибка ERROR_MORE_DATA (234), значение, возвращаемое этим параметром, равно размеру буфера, на который указывает LinkName , должен содержать все данные.

[in, out] LinkName

Указатель на буфер для хранения первого имени ссылки, найденной для lpFileName.

[in, optional] hTransaction

Дескриптор транзакции. Этот дескриптор возвращается функцией CreateTransaction .

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение представляет собой дескриптор поиска, который можно использовать с функцией FindNextFileNameW или закрыть с помощью функции FindClose .

Если функция завершается сбоем, возвращается значение INVALID_HANDLE_VALUE (0xffffffff). Кому
Получите расширенные сведения об ошибке, вызовите функцию GetLastError .

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

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

Требования


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

См. также

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

FindClose

FindNextFileNameW

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