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


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

[Корпорация Майкрософт настоятельно рекомендует разработчикам использовать альтернативные средства для удовлетворения потребностей вашего приложения. Многие сценарии, для работы с которыми был разработан 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 .

Комментарии

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

Технология Поддерживается
Протокол 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