VSS_SNAPSHOT_PROP構造体 (vss.h)

[アーティクル]
08/27/2023

VSS_SNAPSHOT_PROP構造体には、シャドウコピーまたはシャドウコピーセットのプロパティが含まれています。

構文

typedef struct _VSS_SNAPSHOT_PROP {
  VSS_ID             m_SnapshotId;
  VSS_ID             m_SnapshotSetId;
  LONG               m_lSnapshotsCount;
  VSS_PWSZ           m_pwszSnapshotDeviceObject;
  VSS_PWSZ           m_pwszOriginalVolumeName;
  VSS_PWSZ           m_pwszOriginatingMachine;
  VSS_PWSZ           m_pwszServiceMachine;
  VSS_PWSZ           m_pwszExposedName;
  VSS_PWSZ           m_pwszExposedPath;
  VSS_ID             m_ProviderId;
  LONG               m_lSnapshotAttributes;
  VSS_TIMESTAMP      m_tsCreationTimestamp;
  VSS_SNAPSHOT_STATE m_eStatus;
} VSS_SNAPSHOT_PROP, *PVSS_SNAPSHOT_PROP;

メンバー

m_SnapshotId

シャドウコピー識別子を一意に識別する VSS_ID (GUID)。

m_SnapshotSetId

シャドウコピーを含むシャドウコピーセットを一意に識別する VSS_ID (GUID)。

m_lSnapshotsCount

シャドウコピーセットの作成時にシャドウコピーセットに含まれるボリュームの数。アプリケーションでは、シャドウコピーセットを解放せずに個々のシャドウコピーを解放できるため、シャドウコピーセット内のシャドウコピーの数が m_LSnapshotsCount未満になる場合があります。

シャドウコピーセットで許可されるシャドウコピーボリュームの最大数は 64 です。

m_pwszSnapshotDeviceObject

ボリュームのシャドウコピーのデバイスオブジェクトの名前を含む Null で終わるワイド文字列。デバイスオブジェクトは、ボリュームのシャドウコピーのルートと考えることができます。要求者は、操作する必要があるシャドウコピーされたボリューム上のファイルにアクセスするときに、このデバイス名を使用します。

デバイス名に末尾の "" が含まれていません。

m_pwszOriginalVolumeName

シャドウコピーされたボリュームの名前を含む Null で終わるワイド文字列。

m_pwszOriginatingMachine

元のボリュームを含むマシンの名前を含む Null で終わるワイド文字列。

m_pwszServiceMachine

シャドウコピーを作成したボリュームシャドウコピーサービスを実行しているマシンの名前を含む Null で終わるワイド文字列。

m_pwszExposedName

シャドウコピーが公開されたときにシャドウコピーの名前を含む Null で終わるワイド文字列。これは、ドライブ文字またはマウントされたフォルダー (シャドウコピーがローカルボリュームとして公開されている場合)、または共有名です。 IVssBackupComponents::ExposeSnapshot メソッドの wszExpose パラメーターに対応します。

m_pwszExposedPath

共有として公開されている場合に使用できるボリュームのシャドウコピーの部分を示す Null で終わるワイド文字列。 IVssBackupComponents::ExposeSnapshot メソッドの wszPathFromRoot パラメーターに対応します。

m_ProviderId

このシャドウコピーの作成に使用されるプロバイダーを一意に識別する VSS_ID (GUID)。

m_lSnapshotAttributes

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES 列挙体のメンバーのビットマスク (またはビットごとの OR) として表されるシャドウコピーの属性。

m_tsCreationTimestamp

シャドウコピーが作成された日時を示すタイムスタンプ。正確な時刻はプロバイダーによって決定されます。タイムスタンプ形式の詳細については、「 VSS_TIMESTAMP 」を参照してください。

m_eStatus

現在のシャドウコピーの作成状態。「VSS_SNAPSHOT_STATE」を参照してください。

注釈

要求者は通常、IVssBackupComponents::GetSnapshotProperties メソッドまたは IVssSoftwareSnapshotProvider::GetSnapshotProperties メソッドを使用して、VSS_SNAPSHOT_PROP構造体へのポインターを取得します。この構造体が不要になった場合、呼び出し元は VssFreeSnapshotProperties 関数を使用して解放する必要があります。

m_pwszSnapshotDeviceObjectに含まれるシャドウコピーデバイスオブジェクトは、ボリュームのシャドウコピー上のファイルをアドレス指定するために使用されます。たとえば、元のボリュームに "\topleveldir\File.html" のパスを持つファイルがある場合、ファイルのシャドウコピーへのパスは "m_pwszSnapshotDeviceObject"+"\topleveldir\File.html" になります。

シャドウコピーが共有として公開されている場合、 m_pwszExposedName の値は共有名になります。シャドウコピーがドライブ文字またはマウントフォルダーとして公開されている場合、シャドウコピー m_pwszExposedName はドライブ文字の後にコロンが続きます。たとえば、"X:" やマウントされたフォルダーパス ("Y:\MountX" など) です。

シャドウコピーがドライブ文字またはマウントされたフォルダーとして公開されている場合は、(デバイスのマウントと同様に) そのルートから始まるシャドウコピー全体がマウントポイントで公開されます。この場合、 m_pwszExposedPath は null になります。

シャドウコピーが共有として公開されている場合、 m_pwszExposedPath の値は、共有されているボリュームの部分へのパスになります。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
Header	vss.h