MARK_HANDLE_INFO32 構造体 (winioctl.h)

指定したファイルまたはディレクトリ、およびその更新シーケンス番号 (USN) 変更履歴レコードに変更に関するデータをマークするために使用される情報が含まれます。 これは 64 ビット コードに対してのみ定義され、32 ビット コードによって送信 MARK_HANDLE_INFO構造体 を解釈するために存在します。 これは、 FSCTL_MARK_HANDLE IOCTL 制御コードによって使用されます。

構文

typedef struct _MARK_HANDLE_INFO32 {
  union {
    DWORD UsnSourceInfo;
    DWORD CopyNumber;
  } DUMMYUNIONNAME;
  DWORD  UsnSourceInfo;
  UINT32 VolumeHandle;
  DWORD  HandleInfo;
} MARK_HANDLE_INFO32, *PMARK_HANDLE_INFO32;

メンバー

DUMMYUNIONNAME

DUMMYUNIONNAME.UsnSourceInfo

DUMMYUNIONNAME.CopyNumber

UsnSourceInfo

行われる変更の種類。

この操作では、ファイルまたはディレクトリを作成したアプリケーションの観点から外部から変更されることはありません。

スレッドが新しい USN レコードを書き込むとき、前のレコードのソース情報フラグは、スレッドもそれらのフラグを設定した場合にのみ存在し続けます。 したがって、ソース情報構造を使用すると、アプリケーションは、ウイルス対策フィルターなど、既知のソースによってのみ設定された USN レコードを除外できます。

次の値が定義されています。

VolumeHandle

ファイルまたはディレクトリが存在するボリュームへのボリューム ハンドル。 ボリューム ハンドルの取得の詳細については、「解説」セクションを参照してください。

この操作の特権を確認するには、このハンドルが必要です。

呼び出し元には 、SE_MANAGE_VOLUME_NAME 特権が必要です。 詳細については、「 特権」を参照してください。

HandleInfo

VolumeHandle メンバーのハンドル値によって識別されるファイルまたはディレクトリに関する追加情報を指定するフラグ。

要件