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

섀도 복사본 식별자를 고유하게 식별하는 GUID(VSS_ID )입니다.

m_SnapshotSetId

섀도 복사본을 포함하는 섀도 복사본 집합을 고유하게 식별하는 GUID( VSS_ID )입니다.

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 포함된 섀도 복사본 디바이스 개체는 볼륨의 섀도 복사본에 있는 파일의 주소를 지정하는 데 사용됩니다. instance 경우 원래 볼륨에 경로가 "\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 [데스크톱 앱만 해당]
머리글	vss.h