CLS_SCAN_CONTEXT 構造体 (clfs.h)

  • [アーティクル]

ScanLogContainers によってスキャンされるコンテナー、実行されているスキャンの種類、スキャンされたコンテナーを追跡するためのカーソルに関する情報が含まれます。

構文

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;

メンバー

cidNode

現在のノードの ID。 詳細については、「 CLFS_NODE_ID」を参照してください。

hLog

ログ コンテナーをスキャンするためのアクセス許可を持つ CreateLogFile から取得される、スキャン対象のログへのハンドル。

cIndex

現在のコンテナーのインデックス。

cContainers

pinfoContainer が指す配列内のシステム割り当てCLFS_CONTAINER_INFORMATION構造体の数。

つまり、このメンバーは、各スキャン呼び出しでスキャンするコンテナーの数です。 呼び出し元は、返されるコンテナーの数がこの値より少ない場合にスキャンが完了したことを認識します。

cContainersReturned

ScanLogContainers の呼び出し後に返されるコンテナーの数。

eScanMode

コンテナーがスキャンされるモード。

コンテナーは、次のいずれかのモードでスキャンできます。

値 意味
CLFS_SCAN_INIT
 スキャン コンテキストを初期化しますが、関連付けられているストレージは割り当てられません。

現在のスキャン コンテキストに格納されているすべてのデータが失われるため、初期化は破壊的です。
CLFS_SCAN_CLOSE
 スキャン コンテキストを初期化解除し、スキャン コンテキストに関連付けられているシステム ストレージの割り当てを解除します。
CLFS_SCAN_FORWARD
 ScanLogContainers への次の呼び出しを順方向に進めます。

CLFS_SCAN_BACKWARDが指定されている場合は使用できません。
CLFS_SCAN_BACKWARD
 ScanLogContainers への次の呼び出しを逆方向に進めます。

CLFS_SCAN_FORWARDが指定されている場合は使用できません。

pinfoContainer

呼び出しが成功するたびに ScanLogContainers によって入力されるCLFS_CONTAINER_INFORMATION構造体のクライアント割り当て配列へのポインター。

注釈

この構造体はクライアントによって割り当てられ、 CreateLogContainerScanContext を使用して初期化された後、繰り返し呼び出しで ScanLogContainers に渡されます。

要件

要件 値
サポートされている最小のクライアント Windows 10 ビルド 20348
サポートされている最小のサーバー Windows 10 ビルド 20348
Header clfs.h

こちらもご覧ください

CLFS_CONTAINER_INFORMATION

CLFS_NODE_ID

ScanLogContainers