Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

CLFS_SCAN_CONTEXT structure

Contains information about the containers that are being scanned by ScanLogContainers, the kind of scan that is being performed, and a cursor to track which containers have been scanned.

Syntax


typedef struct _CLFS_SCAN_CONTEXT {
  CLFS_NODE_ID                cidNode;
  HANDLE                      hLog;
  ULONG                       cIndex;
  ULONG                       cContainers;
  ULONG                       cContainersReturned;
  CLFS_SCAN_MODE              eScanMode;
  PCLFS_CONTAINER_INFORMATION pinfoContainer;
} CLFS_SCAN_CONTEXT, *PCLFS_SCAN_CONTEXT;

Members

cidNode

The ID of the current node. For more information, see CLFS_NODE_ID.

hLog

A handle to the log being scanned that is obtained from CreateLogFile with permissions to scan the log containers.

cIndex

The index of the current container.

cContainers

The number of system-allocated CLFS_CONTAINER_INFORMATION structures in an array that is pointed to by pinfoContainer.

That is, this member is the number of containers to scan with each scan call. The caller knows the scan is complete when the number of containers returned is less than this value.

cContainersReturned

The number of containers that are returned after a call to ScanLogContainers.

eScanMode

The mode in which containers are scanned.

Containers can be scanned in one of the following modes.

ValueMeaning
CLFS_SCAN_INIT

Initializes the scan context, but does not allocate associated storage.

The initialization is destructive, because all data that is stored in the current scan context is lost.

CLFS_SCAN_CLOSE

Uninitializes the scan context and deallocates system storage that is associated with a scan context.

CLFS_SCAN_FORWARD

Causes the next call to ScanLogContainers to proceed in a forward direction.

Cannot be used if CLFS_SCAN_BACKWARD is specified.

CLFS_SCAN_BACKWARD

Causes the next call to ScanLogContainers to proceed in a backward direction.

Cannot be used if CLFS_SCAN_FORWARD is specified.

 

pinfoContainer

A pointer to a client-allocated array of CLFS_CONTAINER_INFORMATION structures to be filled by ScanLogContainers after each successful call.

Remarks

This structure is allocated by the client, initialized using CreateLogContainerScanContext, and then passed to ScanLogContainers in repeated calls.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 R2 [desktop apps only]

Header

Clfs.h (include Clfsw32.h)

See also

CLFS_CONTAINER_INFORMATION
CLFS_NODE_ID
ScanLogContainers

 

 

Community Additions

ADD
Show:
© 2015 Microsoft