Fungsi ClfsScanLogContainers (wdm.h)
Rutinitas ClfsScanLogContainers mengambil informasi deskriptif untuk urutan kontainer yang termasuk dalam log CLFS tertentu.
CLFSUSER_API NTSTATUS ClfsScanLogContainers(
[in, out] PCLFS_SCAN_CONTEXT pcxScan,
[in] CLFS_SCAN_MODE eScanMode
);
[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 | Arti |
|---|---|
| CLFS_SCAN_FORWARD | Pindai ke arah depan. Misalnya, jika kontainer 5 adalah kontainer yang paling baru 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 paling baru dipindai dan pxcScan->cContainers sama dengan dua, rutinitas ini akan mengembalikan deskriptor untuk kontainer 4 dan 3. |
| CLFS_SCAN_CLOSE | Gratis 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.
ClfsScanLogContainers mengembalikan STATUS_SUCCESS jika berhasil; jika tidak, ia mengembalikan salah satu kode kesalahan yang ditentukan dalam Ntstatus.h.
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 dari anggota cContainers menentukan bahwa setiap kali ClfsScanLogContainers dipanggil, kontainer N berikutnya dipindai.
Anggota CLFS_SCAN_CONTEXTcContainersReturned 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.
Ketika Anda telah 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 Common Log File System.
| Syarat | Nilai |
|---|---|
| klien minimum yang didukung | Tersedia di Windows Server 2003 R2, Windows Vista, dan versi Windows yang lebih baru. |
| Platform Target | Desktop |
| Header | wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h) |
| Pustaka | Clfs.lib |
| DLL | Clfs.sys |
| IRQL | <= APC_LEVEL |