Win32 API 日本語リファレンス
ホームSystem.Ioctl › MARK_HANDLE_INFO32

MARK_HANDLE_INFO32

構造体
サイズx64: 12 バイト / x86: 12 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
Anonymous_Anonymous_e__Union4+0+0使用法ヒント(UsnSourceInfo)等を保持する無名共用体である。
VolumeHandleDWORD4+4+4

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

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

呼び出し元は SE_MANAGE_VOLUME_NAME 特権を持っている必要があります。詳細については、 特権を参照してください。

HandleInfoDWORD4+8+8

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

意味
MARK_HANDLE_PROTECT_CLUSTERS
0x00000001
ハンドルが閉じられるまで、そのファイルはデフラグできないものとしてマークされます。
MARK_HANDLE_TXF_SYSTEM_LOG
0x00000004
ハンドルが閉じられるまで、そのファイルはデフラグできないものとしてマークされます。
MARK_HANDLE_NOT_TXF_SYSTEM_LOG
0x00000008
ハンドルが閉じられるまで、そのファイルはデフラグできないものとしてマークされます。
MARK_HANDLE_REALTIME
0x00000020
実際のファイルの種類に関係なく、そのファイルはリアルタイム読み取り動作用としてマークされます。このフラグでマークされたファイルは、 バッファーなし I/O で開く必要があります。
MARK_HANDLE_NOT_REALTIME
0x00000040
MARK_HANDLE_REALTIME フラグを使用して以前にリアルタイム読み取り動作用としてマークされたファイルは、 このフラグを使用してマークを解除し、リアルタイム動作を取り除くことができます。このフラグでマークされたファイルは、 バッファーなし I/O で開く必要があります。

共用体: _Anonymous_e__Union x64 4B / x86 4B

フィールドサイズx64x86説明
UsnSourceInfoDWORD4+0+0

行われる変更の種類です。

この操作は、ファイルまたはディレクトリを作成したアプリケーションから見て、それらを外部的に変更するものではありません。

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

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

意味
USN_SOURCE_DATA_MANAGEMENT
0x00000001
この操作は、オペレーティング システムによって行われたファイルまたはディレクトリへの変更に関する情報を提供します。

代表的な用途は、リモート記憶域がデータを外部記憶域からローカル記憶域へ移動する場合です。リモート記憶域は階層記憶域管理ソフトウェアです。このような移動では、通常、少なくとも USN_REASON_DATA_OVERWRITE フラグが USN レコードに追加されます。しかし、ユーザーの観点からはデータは変更されていません。レコードを保持する USN_RECORD 構造体の SourceInfo メンバーに USN_SOURCE_DATA_MANAGEMENT があることに注目すれば、その項目に対して書き込み操作が行われたにもかかわらずデータは変更されていないと判断できます。

USN_SOURCE_AUXILIARY_DATA
0x00000002
この操作は、ファイルまたはディレクトリにプライベート データ ストリームを追加します。

例としては、ウイルス検出プログラムがチェックサム情報を追加する場合が挙げられます。ウイルス検出プログラムが項目を変更すると、 システムは USN レコードを生成します。USN_SOURCE_AUXILIARY_DATA は、その変更がアプリケーション データを変更していないことを示します。

USN_SOURCE_REPLICATION_MANAGEMENT
0x00000004
この操作は、レプリケートされたファイルの内容を作成または更新します。

たとえば、ファイル レプリケーション サービスは、レプリケートされたディレクトリ内のファイルを作成または更新するときに このフラグを設定します。

CopyNumberDWORD4+0+0

公式ドキュメント

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

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// MARK_HANDLE_INFO32  (x64 12 / x86 12 バイト)
typedef struct MARK_HANDLE_INFO32 {
    _Anonymous_e__Union Anonymous;
    DWORD VolumeHandle;
    DWORD HandleInfo;
} MARK_HANDLE_INFO32;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct MARK_HANDLE_INFO32
{
    public _Anonymous_e__Union Anonymous;
    public uint VolumeHandle;
    public uint HandleInfo;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure MARK_HANDLE_INFO32
    Public Anonymous As _Anonymous_e__Union
    Public VolumeHandle As UInteger
    Public HandleInfo As UInteger
End Structure
import ctypes
from ctypes import wintypes

class MARK_HANDLE_INFO32(ctypes.Structure):
    _fields_ = [
        ("Anonymous", _Anonymous_e__Union),
        ("VolumeHandle", wintypes.DWORD),
        ("HandleInfo", wintypes.DWORD),
    ]
#[repr(C)]
pub struct MARK_HANDLE_INFO32 {
    pub Anonymous: _Anonymous_e__Union,
    pub VolumeHandle: u32,
    pub HandleInfo: u32,
}
import "golang.org/x/sys/windows"

type MARK_HANDLE_INFO32 struct {
	Anonymous _Anonymous_e__Union
	VolumeHandle uint32
	HandleInfo uint32
}
type
  MARK_HANDLE_INFO32 = record
    Anonymous: _Anonymous_e__Union;
    VolumeHandle: DWORD;
    HandleInfo: DWORD;
  end;
const MARK_HANDLE_INFO32 = extern struct {
    Anonymous: _Anonymous_e__Union,
    VolumeHandle: u32,
    HandleInfo: u32,
};
type
  MARK_HANDLE_INFO32 {.bycopy.} = object
    Anonymous: _Anonymous_e__Union
    VolumeHandle: uint32
    HandleInfo: uint32
struct MARK_HANDLE_INFO32
{
    _Anonymous_e__Union Anonymous;
    uint VolumeHandle;
    uint HandleInfo;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; MARK_HANDLE_INFO32 サイズ: 12 バイト(x64)
dim st, 3    ; 4byte整数×3(構造体サイズ 12 / 4 切り上げ)
; Anonymous : _Anonymous_e__Union (+0, 4byte)  varptr(st)+0 を基点に操作(4byte:入れ子/配列)
; VolumeHandle : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; HandleInfo : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global MARK_HANDLE_INFO32
    #field byte Anonymous 4
    #field int VolumeHandle
    #field int HandleInfo
#endstruct

stdim st, MARK_HANDLE_INFO32        ; NSTRUCT 変数を確保
st->VolumeHandle = 100
mes "VolumeHandle=" + st->VolumeHandle
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。