QueryChangesVirtualDisk 関数 (virtdisk.h)

回復性の高い変更追跡 (RCT) によって追跡される仮想ハード ディスク (VHD) の指定された領域に対する変更に関する情報を取得します。

構文

DWORD QueryChangesVirtualDisk(
  [in]      HANDLE                            VirtualDiskHandle,
  [in]      PCWSTR                            ChangeTrackingId,
  [in]      ULONG64                           ByteOffset,
  [in]      ULONG64                           ByteLength,
  [in]      QUERY_CHANGES_VIRTUAL_DISK_FLAG   Flags,
  [out]     PQUERY_CHANGES_VIRTUAL_DISK_RANGE Ranges,
  [in, out] PULONG                            RangeCount,
  [out]     PULONG64                          ProcessedLength
);

パラメーター

[in] VirtualDiskHandle

OpenVirtualDisk 関数に対する VirtualDiskAccessMask パラメーターに設定されたVIRTUAL_DISK_ACCESS_GET_INFO フラグを使用して開かれている必要がある、開いている VHD へのハンドル。 VHD を開く方法については、「 OpenVirtualDisk 関数」を参照してください。

[in] ChangeTrackingId

VHD の指定された領域が変更されたかどうかを判断するための比較の基礎として使用する仮想ディスクの状態を識別する変更の変更追跡識別子を指定する文字列へのポインター。

[in] ByteOffset

VHD の開始から変更のためにチェックする VHD の領域の先頭までの距離をバイト単位で指定する符号なし long 整数。

[in] ByteLength

変更にチェックする VHD の領域の長さをバイト単位で指定する符号なし long 整数。

[in] Flags

予約済み。 QUERY_CHANGES_VIRTUAL_DISK_FLAG_NONEに設定 します。

[out] Ranges

ChangeTrackingId パラメーターが指定する変更追跡識別子がシールされてから変更された ByteOffset パラメーターと ByteLength パラメーターが指定する領域内の仮想ディスクの領域を示す、QUERY_CHANGES_VIRTUAL_DISK_RANGE構造体の配列。

[in, out] RangeCount

符号なし長整数のアドレス。 入力時の値は、Ranges パラメーターが保持できる配列QUERY_CHANGES_VIRTUAL_DISK_RANGE構造体の数を示します。 出力時に、この値には、メソッドが配列 に配置したQUERY_CHANGES_VIRTUAL_DISK_RANGE 構造体の数が含まれます。

[out] ProcessedLength

メソッドが処理したバイトの合計数を示す符号なし long 整数へのポインター。 これは、BytesLength パラメーターが Ranges パラメーターが指定する配列の使用可能な領域で変更がキャプチャされたことを指定する領域の量を示します。

戻り値

要求の状態。

関数が成功した場合、戻り値は ERROR_SUCCESS され、 Ranges パラメーターには要求された情報が含まれます。

関数が失敗した場合、戻り値はエラー コードです。 詳細については、「 システム エラー コード」を参照してください。

要件

こちらもご覧ください

VHD について

QUERY_CHANGES_VIRTUAL_DISK_RANGE

VHD リファレンス