Bagikan melalui

FSCTL_TXFS_QUERY_RM_INFORMATION IOCTL (winioctl.h)

Catatan

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 selengkapnya, dan alternatif untuk TxF, silakan lihat Alternatif untuk menggunakan Transactional NTFS.

Mengambil informasi untuk manajer sumber daya (RM).

Untuk melakukan operasi ini, panggil fungsi DeviceIoControl dengan parameter berikut.

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
);

Keterangan

FSCTL_TXFS_QUERY_RM_INFORMATION adalah operasi sinkron.

Jika panggilan ini gagal dengan ERROR_BUFFER_TOO_SMALL, anggota BytesRequired dari struktur TXFS_QUERY_RM_INFORMATION menentukan seberapa besar buffer harus agar panggilan berhasil dikembalikan.

Jika Anda menulis aplikasi yang mendukung klien Protokol Blok Pesan Server jarak jauh, Anda harus menggunakan kode kontrol ini untuk menggunakan manajer sumber daya.

Manajer sumber daya dapat dikueri terlepas dari statusnya; jika RM tidak dimulai, ERROR_RM_NOT_ACTIVE dikembalikan. Anda dapat menggunakan informasi tentang rentang aktif log untuk memandu keputusan tentang berapa banyak log yang akan diarsipkan.

Refs: Kode ini tidak didukung.

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