Bagikan melalui

struktur TXFS_QUERY_RM_INFORMATION (winioctl.h)

[Microsoft sangat menyarankan pengembang menggunakan cara alternatif untuk mencapai kebutuhan aplikasi Anda. Banyak skenario yang dikembangkan TxF dapat dicapai melalui teknik yang lebih sederhana dan lebih tersedia. Selain itu, TxF mungkin tidak tersedia di versi Microsoft Windows yang akan datang. Untuk informasi lebih lanjut, dan alternatif TxF, silakan lihat Alternatif untuk menggunakan Transactional NTFS.]

Berisi informasi tentang resource manager (RM).

Sintaks

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;

Anggota

BytesRequired

Jika FSCTL_TXFS_QUERY_RM_INFORMATION mengembalikan ERROR_BUFFER_TOO_SMALL, anggota ini menentukan jumlah minimum byte yang diperlukan untuk mengembalikan informasi yang diminta, termasuk karakter penghentian NULL .

TailLsn

Nomor urutan log terlama (LSN) yang saat ini digunakan oleh RM.

CurrentLsn

LSN baru-baru ini digunakan oleh RM dalam log-nya.

ArchiveTailLsn

LSN dari arsip ekor log.

LogContainerSize

Ukuran aktual kontainer log, dalam byte.

HighestVirtualClock

Tanda waktu tertinggi yang terkait dengan rekaman log.

LogContainerCount

Jumlah kontainer log.

LogContainerCountMax

Jumlah maksimum kontainer log.

LogContainerCountMin

Jumlah minimum kontainer yang diizinkan dalam log.

LogGrowthIncrement

Jumlah log akan bertambah, yang merupakan sejumlah kontainer atau persentase dari ukuran log; jenis pertumbuhan yang digunakan ditentukan oleh bendera yang ditetapkan dalam anggota Bendera .

LogAutoShrinkPercentage

Jika kebijakan penyusutan otomatis aktif, anggota ini menentukan jumlah ruang kosong maksimum yang diizinkan dalam log. Jika anggota ini nol, kebijakan penyusutan otomatis tidak aktif.

Flags

Anggota ini bisa menjadi satu atau beberapa nilai berikut.

Nilai Makna
TXFS_RM_FLAG_LOG_CONTAINER_COUNT_MIN
0x00000008
 Jika bendera diatur, log RM diizinkan untuk menyusut sejauh mungkin. Bendera ini saling eksklusif dengan TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX.
TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_NUM_CONTAINERS
0x00000010
 Menunjukkan jenis nilai dalam LogGrowthIncrement. Jika bendera ini diatur, LogGrowthIncrement adalah sejumlah kontainer. Bendera ini saling eksklusif dengan TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_PERCENT.
TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_PERCENT
0x00000020
 Menunjukkan jenis nilai dalam LogGrowthIncrement. Jika bendera ini diatur, LogGrowthIncrement adalah persentase. Bendera ini saling eksklusif dengan TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_NUM_CONTAINERS.
TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX
0x00000080
 Menunjukkan bahwa log RM dapat tumbuh tanpa batas. Bendera ini saling eksklusif dengan TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MIN.
TXFS_RM_FLAG_RESET_RM_AT_NEXT_START
0x00004000
 Menunjukkan status bendera reset RM saat ini. Jika ini diatur, RM akan mengatur ulang sendiri saat berikutnya dimulai. Bendera ini hanya berlaku untuk RM default, bukan RM sekunder. Bendera ini saling eksklusif dengan TXFS_RM_FLAG_DO_NOT_RESET_RM_AT_NEXT_START.
TXFS_RM_FLAG_DO_NOT_RESET_RM_AT_NEXT_START
0x00008000
 Menunjukkan status bendera reset RM saat ini. Jika ini diatur, RM tidak akan mengatur ulang sendiri saat berikutnya dimulai. Bendera ini hanya berlaku untuk RM default, bukan RM sekunder. Bendera ini saling eksklusif dengan TXFS_RM_FLAG_RESET_RM_AT_NEXT_START.
TXFS_RM_FLAG_PREFER_CONSISTENCY
0x00010000
 Menunjukkan bahwa RM lebih memilih konsistensi transaksi daripada ketersediaan sistem. Bendera ini saling eksklusif dengan TXFS_RM_FLAG_PREFER_AVAILABILITY dan tidak didukung oleh RM default pada volume sistem.
TXFS_RM_FLAG_PREFER_AVAILABILITY
0x00020000
 Menunjukkan bahwa RM lebih memilih ketersediaan sistem daripada konsistensi transaksi. Bendera ini saling eksklusif dengan TXFS_RM_FLAG_PREFER_CONSISTENCY dan dipaksa oleh RM default pada volume sistem.

LoggingMode

Mode pengelogan saat ini.

Nilai Makna
TXFS_LOGGING_MODE_SIMPLE
1
 Pengelogan sederhana digunakan.
TXFS_LOGGING_MODE_FULL
2
 Pengelogan penuh digunakan

Reserved

Dicadangkan.

RmState

Status RM. Nilai yang valid adalah sebagai berikut.

Nilai Makna
TXFS_RM_STATE_NOT_STARTED
0
 RM belum dimulai.
TXFS_RM_STATE_STARTING
1
 RM dimulai.
TXFS_RM_STATE_ACTIVE
2
 RM aktif dan siap menerima transaksi.
TXFS_RM_STATE_SHUTTING_DOWN
3
 RM dimatikan.

LogCapacity

Total kapasitas log, dalam byte.

LogFree

Jumlah byte yang bebas dalam log.

TopsSize

Ukuran file $Tops, dalam byte.

TopsUsed

Jumlah file $Tops yang digunakan, dalam byte.

TransactionCount

Jumlah transaksi aktif, pada saat kueri dikeluarkan.

OnePCCount

Jumlah operasi penerapan fase tunggal yang telah terjadi pada RM ini.

TwoPCCount

Jumlah operasi penerapan dua fase yang telah terjadi pada RM ini.

NumberLogFileFull

Berapa kali log RM ini menjadi penuh.

OldestTransactionAge

Panjang transaksi aktif terlama, dalam milidetik.

RMName

GUID yang menunjukkan nama RM ini.

TmLogPathOffset

Offset dari awal struktur ini ke string Unicode yang dihentikan NULL yang berisi jalur ke log TM.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Header winioctl.h (termasuk Windows.h)

Lihat juga

FSCTL_TXFS_QUERY_RM_INFORMATION

Struktur TxF