FSCTL_TXFS_LIST_TRANSACTION_LOCKED_FILES IOCTL (winioctl.h)

  • Статья

Примечание

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

Возвращает список всех файлов, заблокированных указанной транзакцией. Если возвращаемое значение равно ERROR_MORE_DATA, оно возвращает длину буфера, необходимую для хранения полного списка файлов во время этого вызова.

BOOL DeviceIoControl(
  (HANDLE) hDevice,                         // handle to device
  FSCTL_TXFS_LIST_TRANSACTION_LOCKED_FILES, // dwIoControlCode
  (LPVOID) lpInBuffer,                      // input buffer
  (DWORD) nInBufferSize,                    // size of input buffer
  (LPVOID) lpOutBuffer,                     // output buffer
  (DWORD) nOutBufferSize,                   // size of output buffer
  (LPDWORD) lpBytesReturned,                // number of bytes returned
  (LPOVERLAPPED) lpOverlapped );            // OVERLAPPED structure
);

Комментарии

FSCTL_TXFS_LIST_TRANSACTION_LOCKED_FILES является синхронной операцией.

Возвращаемые имена путей к файлам относятся к корню тома.

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

Refs: Этот код не поддерживается.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Верхняя часть winioctl.h (включая Windows.h)

См. также раздел