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

структура TXFS_QUERY_RM_INFORMATION (winioctl.h)

  • Статья

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

Содержит сведения о диспетчере ресурсов (RM).

Синтаксис

typedef struct _TXFS_QUERY_RM_INFORMATION {
  DWORD         BytesRequired;
  DWORDLONG     TailLsn;
  DWORDLONG     CurrentLsn;
  DWORDLONG     ArchiveTailLsn;
  DWORDLONG     LogContainerSize;
  LARGE_INTEGER HighestVirtualClock;
  DWORD         LogContainerCount;
  DWORD         LogContainerCountMax;
  DWORD         LogContainerCountMin;
  DWORD         LogGrowthIncrement;
  DWORD         LogAutoShrinkPercentage;
  DWORD         Flags;
  WORD          LoggingMode;
  WORD          Reserved;
  DWORD         RmState;
  DWORDLONG     LogCapacity;
  DWORDLONG     LogFree;
  DWORDLONG     TopsSize;
  DWORDLONG     TopsUsed;
  DWORDLONG     TransactionCount;
  DWORDLONG     OnePCCount;
  DWORDLONG     TwoPCCount;
  DWORDLONG     NumberLogFileFull;
  DWORDLONG     OldestTransactionAge;
  GUID          RMName;
  DWORD         TmLogPathOffset;
} TXFS_QUERY_RM_INFORMATION, *PTXFS_QUERY_RM_INFORMATION;

Члены

BytesRequired

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

TailLsn

Самый старый номер последовательности журнала (LSN), используемый в настоящее время RM.

CurrentLsn

Номер LSN, который последний раз использовался RM в журнале.

ArchiveTailLsn

Номер LSN архивного хвоста журнала.

LogContainerSize

Фактический размер контейнера журнала в байтах.

HighestVirtualClock

Самая высокая метка времени, связанная с записью журнала.

LogContainerCount

Количество контейнеров журналов.

LogContainerCountMax

Максимальное число контейнеров журналов.

LogContainerCountMin

Минимальное количество контейнеров, разрешенных в журнале.

LogGrowthIncrement

Объем, на который будет увеличиваться журнал, то есть количество контейнеров или процент от размера журнала; Используемый тип роста определяется флагами, заданными в элементе Flags .

LogAutoShrinkPercentage

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

Flags

Этот элемент может иметь одно или несколько из следующих значений.

Значение Значение
TXFS_RM_FLAG_LOG_CONTAINER_COUNT_MIN
0x00000008
 Если флаг установлен, журнал RM может сжаться как можно дальше. Этот флаг является взаимоисключающим с TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX.
TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_NUM_CONTAINERS
0x00000010
 Указывает тип значения в LogGrowthIncrement. Если этот флаг установлен, LogGrowthIncrement — это несколько контейнеров. Этот флаг является взаимоисключающим с TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_PERCENT.
TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_PERCENT
0x00000020
 Указывает тип значения в LogGrowthIncrement. Если этот флаг установлен, значение LogGrowthIncrement равно процентному значению. Этот флаг является взаимоисключающим с TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_NUM_CONTAINERS.
TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX
0x00000080
 Указывает, что размер журнала RM может увеличиваться без границ. Этот флаг является взаимоисключающим с TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MIN.
TXFS_RM_FLAG_RESET_RM_AT_NEXT_START
0x00004000
 Указывает текущее состояние флага сброса RM. Если этот параметр установлен, при следующем запуске RM сбросит себя. Этот флаг действителен только для модулей RM по умолчанию, но не для вторичных RM. Этот флаг является взаимоисключающим с TXFS_RM_FLAG_DO_NOT_RESET_RM_AT_NEXT_START.
TXFS_RM_FLAG_DO_NOT_RESET_RM_AT_NEXT_START
0x00008000
 Указывает текущее состояние флага сброса RM. Если этот параметр задан, RM не будет сбрасывать себя при следующем запуске. Этот флаг действителен только для модулей RM по умолчанию, но не для вторичных RM. Этот флаг является взаимоисключающим с TXFS_RM_FLAG_RESET_RM_AT_NEXT_START.
TXFS_RM_FLAG_PREFER_CONSISTENCY
0x00010000
 Указывает, что RM предпочитает согласованность транзакций , а не доступность системы. Этот флаг является взаимоисключающим с TXFS_RM_FLAG_PREFER_AVAILABILITY и не поддерживается RM по умолчанию на системном томе.
TXFS_RM_FLAG_PREFER_AVAILABILITY
0x00020000
 Указывает, что RM предпочитает доступность системы , а не согласованность транзакций. Этот флаг является взаимоисключающим с TXFS_RM_FLAG_PREFER_CONSISTENCY и принудительно применяется по умолчанию RM на системном томе.

LoggingMode

Текущий режим ведения журнала.

Значение Значение
TXFS_LOGGING_MODE_SIMPLE
1
 Используется простое ведение журнала.
TXFS_LOGGING_MODE_FULL
2
 Используется полное ведение журнала

Reserved

Зарезервировано.

RmState

Состояние RM. Допустимы следующие значения.

Значение Значение
TXFS_RM_STATE_NOT_STARTED
0
 RM еще не запущен.
TXFS_RM_STATE_STARTING
1
 RM запускается.
TXFS_RM_STATE_ACTIVE
2
 Служба управления правами активна и готова принимать транзакции.
TXFS_RM_STATE_SHUTTING_DOWN
3
 RM завершает работу.

LogCapacity

Общая емкость журнала в байтах.

LogFree

Число свободных байтов в журнале.

TopsSize

Размер файла $Tops в байтах.

TopsUsed

Объем используемого файла $Tops в байтах.

TransactionCount

Количество активных транзакций на момент выдачи запроса.

OnePCCount

Количество однофазных операций фиксации, выполненных в этом RM.

TwoPCCount

Количество двухэтапных операций фиксации, выполненных в этом RM.

NumberLogFileFull

Количество заполнений этого журнала RM.

OldestTransactionAge

Длина самой старой активной транзакции в миллисекундах.

RMName

ИДЕНТИФИКАТОР GUID, указывающий имя этого RM.

TmLogPathOffset

Смещение от начала этой структуры до строки Юникода, заканчивающейся null, которая содержит путь к журналу TM.

Требования

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

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

FSCTL_TXFS_QUERY_RM_INFORMATION

Структуры TxF