FSCTL_TXFS_QUERY_RM_INFORMATION IOCTL (winioctl.h)

  • Статья

Примечание

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

Извлекает сведения для диспетчера ресурсов (RM).

Для выполнения этой операции вызовите функцию DeviceIoControl со следующими параметрами.

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

Комментарии

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

Если этот вызов завершается сбоем с ERROR_BUFFER_TOO_SMALL, член BytesRequired структуры TXFS_QUERY_RM_INFORMATION указывает, насколько большой должен быть буфер для успешного возврата вызова.

Если вы пишете приложение, поддерживающее удаленные клиенты протокола server Message Block Protocol, необходимо использовать этот управляющий код для использования диспетчера ресурсов.

Диспетчер ресурсов может запрашиваться независимо от его состояния; Если RM не запущен, возвращается ERROR_RM_NOT_ACTIVE . Сведения об активном диапазоне журнала можно использовать для принятия решений о том, какую часть журнала следует архивировать.

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

Требования

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

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