struktur CLS_SCAN_CONTEXT (clfs.h)

Artikel
03/16/2023

Berisi informasi tentang kontainer yang sedang dipindai oleh ScanLogContainers, jenis pemindaian yang sedang dilakukan, dan kursor untuk melacak kontainer mana yang telah dipindai.

Sintaks

typedef struct _CLS_SCAN_CONTEXT {
  CLFS_NODE_ID               cidNode;
  HANDLE                     hLog;
  ULONG                      cIndex;
  ULONG                      cContainers;
  ULONG                      cContainersReturned;
  CLFS_SCAN_MODE             eScanMode;
  PCLS_CONTAINER_INFORMATION pinfoContainer;
} CLS_SCAN_CONTEXT, *PCLS_SCAN_CONTEXT, PPCLS_SCAN_CONTEXT;

Anggota

cidNode

ID simpul saat ini. Untuk informasi selengkapnya, lihat CLFS_NODE_ID.

hLog

Handel ke log yang sedang dipindai yang diperoleh dari CreateLogFile dengan izin untuk memindai kontainer log.

cIndex

Indeks kontainer saat ini.

cContainers

Jumlah struktur CLFS_CONTAINER_INFORMATION yang dialokasikan sistem dalam array yang ditunjukkan oleh pinfoContainer.

Artinya, anggota ini adalah jumlah kontainer untuk dipindai dengan setiap panggilan pemindaian. Pemanggil tahu pemindaian selesai ketika jumlah kontainer yang dikembalikan kurang dari nilai ini.

cContainersReturned

Jumlah kontainer yang dikembalikan setelah panggilan ke ScanLogContainers.

eScanMode

Mode di mana kontainer dipindai.

Kontainer dapat dipindai dalam salah satu mode berikut.

Nilai	Makna
CLFS_SCAN_INIT	Menginisialisasi konteks pemindaian, tetapi tidak mengalokasikan penyimpanan terkait. Inisialisasi merusak, karena semua data yang disimpan dalam konteks pemindaian saat ini hilang.
CLFS_SCAN_CLOSE	Membatalkan menginisialisasi konteks pemindaian dan membatalkan alokasi penyimpanan sistem yang terkait dengan konteks pemindaian.
CLFS_SCAN_FORWARD	Menyebabkan panggilan berikutnya ke ScanLogContainers dilanjutkan ke arah penerusan. Tidak dapat digunakan jika CLFS_SCAN_BACKWARD ditentukan.
CLFS_SCAN_BACKWARD	Menyebabkan panggilan berikutnya ke ScanLogContainers dilanjutkan ke arah mundur. Tidak dapat digunakan jika CLFS_SCAN_FORWARD ditentukan.

pinfoContainer

Penunjuk ke array struktur CLFS_CONTAINER_INFORMATION yang dialokasikan klien untuk diisi oleh ScanLogContainers setelah setiap panggilan berhasil.

Keterangan

Struktur ini dialokasikan oleh klien, diinisialisasi menggunakan CreateLogContainerScanContext, lalu diteruskan ke ScanLogContainers dalam panggilan berulang.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10 Build 20348
Server minimum yang didukung	Windows 10 Build 20348
Header	clfs.h

Lihat juga

CLFS_CONTAINER_INFORMATION

CLFS_NODE_ID

ScanLogContainers

Bagikan melalui