Fungsi ClfsScanLogContainers (wdm.h)

  • Artikel

Rutinitas ClfsScanLogContainers mengambil informasi deskriptif untuk urutan kontainer milik log CLFS tertentu.

Sintaks

CLFSUSER_API NTSTATUS ClfsScanLogContainers(
  [in, out] PCLFS_SCAN_CONTEXT pcxScan,
  [in]      CLFS_SCAN_MODE     eScanMode
);

Parameter

[in, out] pcxScan

Penunjuk ke struktur CLFS_SCAN_CONTEXT . Pemanggil sebelumnya mengalokasikan struktur dan menginisialisasinya dengan memanggil ClfsCreateScanContext. Secara khusus, anggota pInfoContainer diinisialisasi untuk menunjuk ke array struktur CLFS_CONTAINER_INFORMATION , dan anggota cContainers diinisialisasi ke jumlah elemen dalam array. Saat dikembalikan, struktur dalam array menerima informasi deskriptif untuk kontainer secara berurutan.

[in] eScanMode

Sekumpulan bendera yang menentukan arah pemindaian dan apakah konteks pemindaian harus ditutup. Bendera berikut tersedia untuk pemanggil rutinitas ini.

Nilai Makna
CLFS_SCAN_FORWARD Pindai ke arah depan. Misalnya, jika kontainer 5 adalah kontainer yang terakhir dipindai dan pxcScan->cContainers sama dengan dua, rutinitas ini akan mengembalikan deskriptor untuk kontainer 6 dan 7.
CLFS_SCAN_BACKWARD Pindai ke arah mundur. Misalnya, jika kontainer 5 adalah kontainer yang terakhir dipindai dan pxcScan->cContainers sama dengan dua, rutinitas ini akan mengembalikan deskriptor untuk kontainer 4 dan 3.
CLFS_SCAN_CLOSE Bebaskan semua sumber daya yang terkait dengan konteks pemindaian yang ditujukkan oleh pcxScan.
 

Jika bendera CLFS_SCAN_CLOSE diatur, bendera CLFS_SCAN_FORWARD dan CLFS_SCAN_BACKWARD harus jelas.

Jika bendera CLFS_SCAN_CLOSE jelas, hanya salah satu bendera arah (CLFS_SCAN_FORWARD atau CLFS_SCAN_BACKWARD) yang harus diatur.

Nilai kembali

ClfsScanLogContainers mengembalikan STATUS_SUCCESS jika berhasil; jika tidak, ia mengembalikan salah satu kode kesalahan yang ditentukan dalam Ntstatus.h.

Keterangan

CLFS menggunakan struktur CLFS_SCAN_CONTEXT untuk melacak di mana pemindaian kontainer dimulai (anggota cIndex ) dan berapa banyak kontainer yang dipindai dalam setiap panggilan ke ClfsScanLogContainers. Nilai N anggota cContainers menentukan bahwa setiap kali ClfsScanLogContainers dipanggil, kontainer N berikutnya dipindai.

Anggota cContainersReturned dari struktur CLFS_SCAN_CONTEXT menerima jumlah kontainer yang benar-benar dipindai dalam satu panggilan ke ClfsScanLogContainers.

Ketika ClfsScanLogContainers mengembalikan STATUS_NO_MORE_ENTRIES, tidak ada lagi kontainer yang akan dipindai.

Setelah selesai menggunakan konteks pemindaian yang ditujukan oleh pcxScan, Anda harus memanggil ClfsScanLogContainers, dengan eScanMode sama dengan CLFS_SCAN_CLOSE, untuk membebaskan sumber daya apa pun yang terkait dengan konteks pemindaian.

Untuk penjelasan tentang konsep dan terminologi CLFS, lihat Sistem File Log Umum.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Windows Server 2003 R2, Windows Vista, dan versi Windows yang lebih baru.
Target Platform Desktop
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

Lihat juga

CLFS_CONTAINER_INFORMATION

CLFS_SCAN_CONTEXT

ClfsCreateScanContext