VSS_VOLUME_SNAPSHOT_ATTRIBUTES 열거형(vss.h)

아티클
08/27/2023

섀도 복사본에 대해 추가 특성을 지정할 수 있습니다. 섀도 복사본의 컨텍스트( IVssBackupComponents::SetContext 메서드에서 설정한 대로)는 유효한 _VSS_VOLUME_SNAPSHOT_ATTRIBUTES 및 _VSS_SNAPSHOT_CONTEXT 열거형 값의 조합을 포함하는 비트 마스크에 의해 수정될 수 있습니다.

Syntax

typedef enum _VSS_VOLUME_SNAPSHOT_ATTRIBUTES {
  VSS_VOLSNAP_ATTR_PERSISTENT = 0x1,
  VSS_VOLSNAP_ATTR_NO_AUTORECOVERY = 0x2,
  VSS_VOLSNAP_ATTR_CLIENT_ACCESSIBLE = 0x4,
  VSS_VOLSNAP_ATTR_NO_AUTO_RELEASE = 0x8,
  VSS_VOLSNAP_ATTR_NO_WRITERS = 0x10,
  VSS_VOLSNAP_ATTR_TRANSPORTABLE = 0x20,
  VSS_VOLSNAP_ATTR_NOT_SURFACED = 0x40,
  VSS_VOLSNAP_ATTR_NOT_TRANSACTED = 0x80,
  VSS_VOLSNAP_ATTR_HARDWARE_ASSISTED = 0x10000,
  VSS_VOLSNAP_ATTR_DIFFERENTIAL = 0x20000,
  VSS_VOLSNAP_ATTR_PLEX = 0x40000,
  VSS_VOLSNAP_ATTR_IMPORTED = 0x80000,
  VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY = 0x100000,
  VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY = 0x200000,
  VSS_VOLSNAP_ATTR_AUTORECOVER = 0x400000,
  VSS_VOLSNAP_ATTR_ROLLBACK_RECOVERY = 0x800000,
  VSS_VOLSNAP_ATTR_DELAYED_POSTSNAPSHOT = 0x1000000,
  VSS_VOLSNAP_ATTR_TXF_RECOVERY = 0x2000000,
  VSS_VOLSNAP_ATTR_FILE_SHARE = 0x4000000
} VSS_VOLUME_SNAPSHOT_ATTRIBUTES, *PVSS_VOLUME_SNAPSHOT_ATTRIBUTES;

상수


`VSS_VOLSNAP_ATTR_PERSISTENT` 값: 0x1 섀도 복사본은 다시 부팅할 때 지속됩니다. 이 특성은 에 대해 자동으로 설정됩니다. _VSS_SNAPSHOT_CONTEXT 컨텍스트 VSS_CTX_APP_ROLLBACK, VSS_CTX_CLIENT_ACCESSIBLE, VSS_CTX_CLIENT_ACCESSIBLE_WRITERS 및 VSS_CTX_NAS_ROLLBACK. 섀도 복사본의 컨텍스트를 설정할 때 요청자가 이 특성을 명시적으로 사용하면 안 됩니다.
`VSS_VOLSNAP_ATTR_NO_AUTORECOVERY` 값: 0x2 섀도 복사본에 대해 자동 복구를 사용할 수 없습니다. 요청자는 이 특성의 비트 OR을 사용하여 섀도 복사본 컨텍스트를 수정할 수 있습니다. 이렇게 하면 요청자는 기록기 또는 다른 애플리케이션이 섀도 복사본의 구성 요소를 업데이트할 수 없도록 섀도 복사본을 만든 직후에 읽기 전용으로 만들도록 VSS에 지시합니다. 자동 복구를 사용하지 않도록 설정하면 TxF(트랜잭션 NTFS)에서 관리하는 트랜잭션 읽기 및 쓰기 작업과 같은 트랜잭션 데이터베이스 작업에 해당 구성 요소가 포함된 경우 섀도 복사본이 일관되지 않은 상태가 될 수 있습니다. 자동 복구를 사용하지 않도록 설정하면 불완전한 트랜잭션이 롤백되지 않도록 하기 때문입니다. 자동 복구를 사용하지 않도록 설정하면 기록기가 섀도 복사본에서 파일을 제외할 수 없게 됩니다. 자동 복구를 사용하지 않도록 설정하면 기록기는 IVssCreateWriterMetadataEx::AddExcludeFilesFromSnapshot 메서드를 호출할 수 있지만 기록기의 CVssWriter::OnPostSnapshot 메서드는 섀도 복사본에서 파일을 삭제할 수 없습니다. Windows Server 2003 및 Windows XP: 이 값은 Windows Vista까지 지원되지 않습니다.
`VSS_VOLSNAP_ATTR_CLIENT_ACCESSIBLE` 값: 0x4 지정된 섀도 복사본은 공유 폴더에 대한 섀도 복사본을 지원하는 클라이언트에서 액세스할 수 있는 섀도 복사본 이며 노출되어서는 안 됩니다. 이 특성은 VSS_CTX_CLIENT_ACCESSIBLE 및VSS_CTX_CLIENT_ACCESSIBLE_WRITERS 대해 자동으로 설정됩니다. 섀도 복사본의 컨텍스트를 설정할 때 요청자가 이 특성을 명시적으로 사용하면 안 됩니다.
`VSS_VOLSNAP_ATTR_NO_AUTO_RELEASE` 값: 0x8 섀도 복사본 요청자 프로세스가 종료되면 섀도 복사본이 자동으로 삭제되지 않습니다. 섀도 복사본 은 에 대한 호출로만 삭제할 수 있습니다. IVssBackupComponents::D eleteSnapshots. 이 특성은 에 대해 자동으로 설정됩니다. _VSS_SNAPSHOT_CONTEXT 컨텍스트 VSS_CTX_APP_ROLLBACK, VSS_CTX_CLIENT_ACCESSIBLE, VSS_CTX_CLIENT_ACCESSIBLE_WRITERS 및 VSS_CTX_NAS_ROLLBACK. 섀도 복사본의 컨텍스트를 설정할 때 요청자가 이 특성을 명시적으로 사용하면 안 됩니다.
`VSS_VOLSNAP_ATTR_NO_WRITERS` 값: 0x10 섀도 복사본을 만드는 데는 기록기가 없습니다. 이 특성은 에 대해 자동으로 설정됩니다. _VSS_SNAPSHOT_CONTEXT 컨텍스트 VSS_CTX_NAS_ROLLBACK, VSS_CTX_FILE_SHARE_BACKUP 및 VSS_CTX_CLIENT_ACCESSIBLE. 섀도 복사본의 컨텍스트를 설정할 때 요청자가 이 특성을 명시적으로 사용하면 안 됩니다.
`VSS_VOLSNAP_ATTR_TRANSPORTABLE` 값: 0x20 섀도 복사본은 전송되므로 로컬로 표시해서는 안 됩니다. 이 특성은 섀도 복사본의 컨텍스트를 설정할 때 요청자가 명시적으로 사용할 수 있습니다. 섀도 복사본 공급자는 전송 가능한 섀도 복사본을 지원합니다. Windows Server 2003, Standard Edition, Windows Server 2003, Web Edition 및 Windows XP: 이 특성은 지원되지 않습니다. SP1이 있는 Windows Server 2003의 모든 버전은 이 특성을 지원합니다. 전송 가능 가져오기를 참조하세요 . 자세한 내용은 복사된 볼륨 섀도입니다.
`VSS_VOLSNAP_ATTR_NOT_SURFACED` 값: 0x40 섀도 복사본은 현재 노출되지 않습니다. 섀도 복사본이 명시적으로 노출되거나 탑재되지 않는 한 이 특성은 모든 섀도 복사본에 대해 설정됩니다. 섀도 복사본의 컨텍스트를 설정할 때 요청자가 이 특성을 명시적으로 사용하면 안 됩니다.
`VSS_VOLSNAP_ATTR_NOT_TRANSACTED` 값: 0x80 섀도 복사본이 트랜잭션되지 않습니다. 요청자는 이 특성의 비트 OR을 사용하여 섀도 복사본 컨텍스트를 수정할 수 있습니다. 이렇게 하면 요청자는 VSS와 트랜잭션 및 리소스 관리자 간의 기본 제공 통합을 사용하지 않도록 VSS에 지시합니다. 이 특성을 설정하면 요청자가 VSS_E_TRANSACTION_FREEZE_TIMEOUT 오류를 수신하지 않습니다. 그러나 트랜잭션 무결성 손실 또는 데이터 손실과 같은 원치 않는 결과가 발생할 수 있습니다. Windows Server 2003 및 Windows XP: 이 값은 Windows Vista까지 지원되지 않습니다.
`VSS_VOLSNAP_ATTR_HARDWARE_ASSISTED` 값: 0x10000 지정된 공급자가 하드웨어 공급자임을 나타냅니다. 이 특성은 하드웨어 공급자에 대해 자동으로 설정됩니다. 이 열거형 값은 컨텍스트를 수동으로 설정하는 데 사용할 수 없습니다(사용) IVssBackupComponents::SetContext 메서드) 이 열거형 값의 비트 마스크(또는 비트 OR)와 유효한 섀도 복사본에 의한 섀도 복사본 컨텍스트 값 _VSS_SNAPSHOT_CONTEXT.
`VSS_VOLSNAP_ATTR_DIFFERENTIAL` 값: 0x20000 지정된 공급자가 차등 데이터 또는 쓰기 중 복사 메커니즘을 사용하여 섀도 복사본을 구현했음을 나타냅니다. 요청자는 이 특성의 비트 OR을 사용하여 섀도 복사본 컨텍스트를 수정할 수 있습니다. 이렇게 하면 요청자는 차등 구현을 사용하여 섀도 복사본을 만들도록 공급자에게 지시합니다. 섀도 복사본이 없는 경우 시스템에 설치된 공급자가 요청된 특성을 지원합니다. VSS_E_VOLUME_NOT_SUPPORTED 오류가 발생합니다. 반환됨 IVssBackupComponents::AddToSnapshotSet.
`VSS_VOLSNAP_ATTR_PLEX` 값: 0x40000 지정된 공급자가 PLEX 또는 미러된 분할 메커니즘을 사용하여 섀도 복사본을 구현한다는 것을 나타냅니다. 요청자는 이 특성의 비트 OR을 사용하여 섀도 복사본 컨텍스트를 수정할 수 있습니다. 이렇게 하면 요청자는 공급자에게 PLEX 구현을 사용하여 섀도 복사본을 만들도록 지시합니다. 섀도 복사본이 없는 경우 시스템에 설치된 공급자가 요청된 특성을 지원합니다. VSS_E_VOLUME_NOT_SUPPORTED 오류가 발생합니다. 반환됨 IVssBackupComponents::AddToSnapshotSet.
`VSS_VOLSNAP_ATTR_IMPORTED` 값: 0x80000 볼륨의 섀도 복사본을 를 사용하여 이 컴퓨터로 가져왔습니다. IVssBackupComponents::ImportSnapshots 메서드를 사용하여 만든 것이 아니라 IVssBackupComponents::D oSnapshotSet 메서드를 재정의합니다. 섀도 복사본을 가져오면 이 특성이 자동으로 설정됩니다. 섀도 복사본의 컨텍스트를 설정할 때 요청자가 이 특성을 명시적으로 사용하면 안 됩니다.
`VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY` 값: 0x100000 섀도 복사본은 로컬로 노출됩니다. 이 비트 플래그 및 VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY 비트 플래그가 인 경우 설정되지 않음, 섀도 복사본이 숨겨집니다. 특성은 를 호출할 때 섀도 복사본 컨텍스트에 자동으로 추가됩니다. IVssBackupComponents::ExposeSnapshot 메서드를 사용하여 섀도 복사본을 로컬로 노출합니다. 섀도 복사본의 컨텍스트를 설정할 때 요청자가 이 특성을 명시적으로 사용하면 안 됩니다.
`VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY` 값: 0x200000 섀도 복사본이 원격으로 노출됩니다. 이 비트 플래그 및 VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY 비트 플래그가 인 경우 설정되지 않음, 섀도 복사본이 숨겨집니다. 특성은 를 호출할 때 섀도 복사본 컨텍스트에 자동으로 추가됩니다. IVssBackupComponents::ExposeSnapshot 메서드를 사용하여 섀도 복사본을 로컬로 노출합니다. 섀도 복사본의 컨텍스트를 설정할 때 요청자가 이 특성을 명시적으로 사용하면 안 됩니다.
`VSS_VOLSNAP_ATTR_AUTORECOVER` 값: 0x400000 작성기가 CVssWriter::OnPostSnapshot에서 구성 요소를 자동으로 복구해야 했음을 나타냅니다. 섀도 복사본의 컨텍스트를 설정할 때 요청자가 이 특성을 명시적으로 사용하면 안 됩니다.
`VSS_VOLSNAP_ATTR_ROLLBACK_RECOVERY` 값: 0x800000 섀도 복사본이 롤백에 사용되는 경우(예: 데이터 마이닝의 경우) 작성기가 CVssWriter::OnPostSnapshot에서 구성 요소를 자동으로 복구해야 했음을 나타냅니다. 요청자는 섀도 복사본 컨텍스트에서 이 플래그를 설정하여 데이터 마이닝과 같은 백업이 아닌 용도로 섀도 복사본을 만들고 있음을 나타냅니다.
`VSS_VOLSNAP_ATTR_DELAYED_POSTSNAPSHOT` 값: 0x1000000 시스템에서 사용하도록 예약되었습니다. Windows Vista, Windows Server 2003 및 Windows XP: 이 값은 Windows Server 2008까지 지원되지 않습니다.
`VSS_VOLSNAP_ATTR_TXF_RECOVERY` 값: 0x2000000 섀도 복사본을 만드는 동안 TxF 복구를 적용해야 했음을 나타냅니다. Windows Vista, Windows Server 2003 및 Windows XP: 이 값은 Windows Server 2008까지 지원되지 않습니다.
`VSS_VOLSNAP_ATTR_FILE_SHARE` 값: 0x4000000

설명

VSS 섀도 복사본의 기본 컨텍스트는 VSS_CTX_BACKUP.

요청자는 _VSS_SNAPSHOT_CONTEXT 열거형의 멤버를 IVssBackupComponents::SetContext 메서드에 전달하여 섀도 복사본의 컨텍스트를 만듭니다.

요청자는 _VSS_VOLUME_SNAPSHOT_ATTRIBUTES 열거형의 지원되는 값과 함께 _VSS_SNAPSHOT_CONTEXT 값의 비트 OR을 IVssBackupComponents::SetContext에 대한 인수로 사용하여 이 컨텍스트를 수정할 수 있습니다.

지정된 메커니즘을 지원하도록 특별히 요청하지 않는 한 공급자는 모든 유형의 메커니즘을 사용하여 섀도 복사본을 구현할 수 있습니다. 따라서 섀도 복사본 메서드를 지정하지 않은 경우 공급자는 차등 메커니즘(VSS_VOLSNAP_ATTR_DIFFERENTIAL), PLEX 메커니즘(VSS_VOLSNAP_ATTR_PLEX) 또는 섀도 복사본을 지원하는 다른 메커니즘을 자유롭게 선택할 수 있습니다.

공급자는 두 메커니즘을 모두 지원할 수 있지만 지정된 섀도 복사본에 대해 상호 배타적입니다. 요청자는 VSS_VOLSNAP_ATTR_DIFFERENTIAL 및 VSS_VOLSNAP_ATTR_PLEX 모두 사용하여 특정 섀도 복사본 컨텍스트를 수정해서는 안 됩니다.

현재 VSS_VOLSNAP_ATTR_DIFFERENTIAL, VSS_VOLSNAP_ATTR_PLEX 및 VSS_VOLSNAP_ATTR_TRANSPORTABLE 컨텍스트를 수정하는 데 사용할 수 있는 _VSS_VOLUME_SNAPSHOT_ATTRIBUTES 열거형의 유일한 값입니다.

또한 VSS_CTX_CLIENT_ACCESSIBLE 컨텍스트를 수정하는 데 사용할 수 없습니다.

요청자는 IVssBackupComponents::GetSnapshotProperties 호출로 반환된 VSS_OBJECT_PROP 구조체에서 VSS_SNAPSHOT_PROP 구조체의 압축을 풀면 특정 섀도 복사본(VSS_ID 식별됨)에 대한 정보를 가져올 수 있습니다.

요청자는 IVssBackupComponents::Query를 호출하고 IVssEnumObject를 사용하여 반환을 반복하여 각 섀도 복사본에 대한 VSS_SNAPSHOT_PROP 구조를 가져올 수도 있습니다.

섀도 복사본의 컨텍스트 및 특성은 VSS_SNAPSHOT_PROP 구조체의 m_lSnapshotAttributes 멤버에 포함된 비트 마스크로 발견됩니다.

요구 사항


지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
머리글	vss.h