VSS_COMPONENTINFO 구조체(vsbackup.h)

아티클
08/27/2023

VSS_COMPONENTINFO 구조체는 지정된 구성 요소에 대한 정보를 포함하며 IVssWMComponent 인터페이스에 의해 요청자에게 반환됩니다.

구문

typedef struct _VSS_COMPONENTINFO {
  VSS_COMPONENT_TYPE type;
  BSTR               bstrLogicalPath;
  BSTR               bstrComponentName;
  BSTR               bstrCaption;
  BYTE               *pbIcon;
  UINT               cbIcon;
  bool               bRestoreMetadata;
  bool               bNotifyOnBackupComplete;
  bool               bSelectable;
  bool               bSelectableForRestore;
  DWORD              dwComponentFlags;
  UINT               cFileCount;
  UINT               cDatabases;
  UINT               cLogFiles;
  UINT               cDependencies;
} VSS_COMPONENTINFO;

멤버

type

구성 요소 유형입니다. VSS_COMPONENT_TYPE 참조하세요.

bstrLogicalPath

구성 요소의 논리적 경로를 포함하는 문자열입니다.

논리 경로는 NULL일 수 있습니다.

NULL이 아닌 논리 경로에 나타날 수 있는 문자에는 제한이 없습니다.

bstrComponentName

구성 요소의 이름을 포함하는 문자열입니다. 구성 요소 이름 문자열은 NULL일 수 없습니다.

bstrCaption

구성 요소에 대한 설명을 포함하는 문자열입니다. 캡션 문자열은 NULL일 수 있습니다.

pbIcon

구성 요소를 나타내는 표시 가능한 아이콘에 대한 이진 데이터를 포함하는 버퍼에 대한 포인터입니다. 버퍼 콘텐츠는 표준 아이콘(.ico) 파일과 동일한 형식을 사용해야 합니다. 버퍼의 크기(바이트)는 cbIcon으로 지정됩니다.

구성 요소를 만든 작성기가 아이콘을 지정하지 않은 경우 pbIcon 은 NULL입니다.

cbIcon

구성 요소를 나타내는 표시 가능한 아이콘(pbIcon)의 크기(바이트)입니다. pbIcon이 NULL인 경우 cbIcon은 0이어야 합니다.

bRestoreMetadata

구성 요소의 복원과 관련된 프라이빗 메타데이터가 있는지 여부를 나타내는 부울입니다. 메타데이터가 있는 경우 부울은 true 이고, 그렇지 않은 경우 false 입니다.

작성기는 IVssCreateWriterMetadata::AddComponent를 사용하여 구성 요소를 추가할 때 이 값을 설정하여 구성 요소가 프라이빗 메타데이터를 지원하는지 여부를 나타냅니다. 작성기는 나중에 IVssComponent::SetRestoreMetadata를 사용하여 복원 메타데이터를 추가합니다. 요청자는 IVssComponent::GetRestoreMetadata를 사용하여 정보를 검색합니다.

bNotifyOnBackupComplete

다음에 사용하도록 예약됩니다. 이 매개 변수의 값은 항상 false로 설정해야 합니다.

bSelectable

구성 요소가 백업에 대해 선택 가능한지 여부를 나타내는 부울입니다(구성 요소 모드 작업의 경우). bSelectable 값은 요청자에게 백업 작업에 지정된 구성 요소를 포함하거나 제외할 수 있는 옵션이 있는지 여부를 결정하는 데 도움이 됩니다. 구성 요소가 백업에 대해 선택 가능한 경우 부울은 true 이고 그렇지 않은 경우 false 입니다.

구성 요소의 백업 선택 가능성에 대한 기본값은 없습니다. 작성기는 IVsCreateWriterMetadata::AddComponent를 사용하여 작성기 메타데이터 문서에 구성 요소를 추가할 때 항상 값을 명시적으로 설정해야 합니다.

또한 bSelectable 값, 구성 요소의 논리 경로 및 해당 경로에 표현된 다른 구성 요소와 구성 요소의 관계는 구성 요소가 백업 작업에 포함되는 시기와 방법을 결정합니다.

논리 경로의 계층 구조에서 백업 상위 항목에 대해 선택할 수 없는 백업 구성 요소(bSelectable is false)에 대해 선택할 수 없는 경우 백업 집합에 포함은 항상 필수이며 항상 암시적입니다. 요청자는 IVsBackupComponents::AddComponent를 사용하여 백업 구성 요소 문서의 백업 집합에 구성 요소를 명시적으로 추가합니다.
논리 경로의 계층 구조에서 백업 상위 항목에 대해 선택할 수 없는 백업 구성 요소(bSelectable is true)에 대해 선택할 수 있는 경우 백업 집합에 포함은 항상 선택 사항이며 항상 명시적입니다. 요청자는 IVsBackupComponents::AddComponent를 사용하여 백업 구성 요소 문서의 백업 집합에 구성 요소를 명시적으로 추가합니다.
이러한 구성 요소가 백업에 대해 선택할 수 있는 구성 요소와 그렇지 않은 구성 요소 모두 다른 구성 요소의 논리적 경로에 상위 항목으로 포함된 경우 이러한 다른 구성 요소를 포함하는 구성 요소 집합을 하위 구성 요소로 정의합니다. 백업 구성 요소에 대한 선택 가능 항목이 백업에 명시적으로 포함된 경우 이러한 하위 구성 요소는 백업에 암시적으로 포함됩니다.
논리 경로의 계층 구조에서 백업 상위 항목에 대해 선택할 수 있는 백업 구성 요소(bSelectable is false)에 대해 선택할 수 없는 경우(따라서 해당 상위 항목이 정의한 구성 요소 집합의 일부임) 백업 집합에 포함되는 것은 항상 암시적이며 백업 상위 항목에 대해 선택 가능한 항목이 포함되는 경우에 따라 달라집니다. 요청자는 백업 구성 요소 문서의 백업 집합에 구성 요소를 명시적으로 추가하지 않습니다. 대신 IVssBackupComponents::AddComponent를 사용하여 백업 상위 항목에 대한 선택 가능 항목을 문서에 추가합니다.
논리 경로의 계층 구조에서 백업 상위 항목에 대해 선택할 수 있는 백업 구성 요소(bSelectable is true)의 경우(따라서 해당 상위 항목이 정의한 구성 요소 집합의 일부임) 백업 집합에 포함되는 것은 선택 사항이며 명시적일 수 있습니다. 또는 구성 요소가 명시적으로 선택되지 않은 경우 해당 포함은 암시적이고 백업 상위 항목에 대해 선택할 수 있는 포함에 따라 달라질 수 있습니다. 구성 요소 포함이 명시적이면 요청자는 IVssBackupComponents::AddComponent를 사용하여 백업 구성 요소 문서의 백업 집합에 구성 요소를 명시적으로 추가합니다.
포함이 암시적이면 요청자는 백업 구성 요소 문서의 백업 집합에 이러한 구성 요소를 추가하지 않습니다.

구성 요소 포함이 명시적이고 구성 요소가 구성 요소 집합을 정의하는 경우 해당 구성 요소 집합의 멤버가 암시적으로 선택됩니다.

작성기는 IVssCreateWriterMetadata::AddComponent를 사용하여 작성기 메타데이터 문서에 구성 요소를 추가할 때 구성 요소의 백업 선택 가능성(bSelectable)을 설정합니다.

자세한 내용은 선택 가능성 및 논리 경로 작업을 참조하세요 .

bSelectableForRestore

구성 요소를 복원할 수 있는지 여부를 나타내는 부울입니다(구성 요소 모드 작업의 경우). bSelectableForRestore 를 사용하면 요청자가 이전에 백업에 암시적으로 포함 되었던 경우 복원을 위해 이 구성 요소를 개별적으로 선택할 수 있는지 여부를 확인할 수 있습니다. 구성 요소가 복원을 위해 선택 가능한 경우 부울은 true 이고 그렇지 않은 경우 false 입니다.

기본적으로 구성 요소의 복원 선택 가능성은 false입니다. 작성기는 IVsCreateWriterMetadata::AddComponent를 사용하여 작성기 메타데이터 문서에 구성 요소를 추가할 때 이 기본값을 재정의할 수 있습니다.

구성 요소가 백업 문서에 명시적으로 추가된 경우( 명시적 구성 요소 포함 참조) 복원을 위해 항상 개별적으로 선택할 수 있습니다. 따라서 이 플래그는 의미가 없습니다. 구성 요소가 백업 문서에 암시적으로 추가된 경우 bSelectableForRestore 플래그는 IVssBackupComponents::AddRestoreSubcomponent를 사용하여 구성 요소를 개별적으로 복원할 수 있는지 여부를 결정합니다.

자세한 내용은 선택 가능성 및 논리 경로 작업을 참조하세요 .

dwComponentFlags

이 구성 요소가 지원하는 기능을 나타내는 VSS_COMPONENT_FLAGS 열거형 값의 비트 마스크(또는 비트 OR)입니다.

Windows Server 2003 및 Windows XP: WINDOWS Server 2003 SP1 이전에는 이 멤버가 시스템 사용을 위해 예약되어 있습니다.

cFileCount

구성 요소가 파일 그룹인 경우 그룹의 파일에 대한 파일 설명자 수입니다. 그렇지 않으면 이 값은 0입니다.

cDatabases

구성 요소가 데이터베이스인 경우 데이터베이스 파일 설명자의 수입니다. 그렇지 않으면 이 값은 0입니다.

cLogFiles

구성 요소가 데이터베이스인 경우 데이터베이스 로그 파일 설명자의 수입니다. 그렇지 않으면 이 매개 변수의 값이 0입니다.

cDependencies

현재 구성 요소의 명시적 기록기 구성 요소 종속성 수입니다. 이 값은 기록기에서 IVssCreateWriterMetadata::AddComponentDependency 를 호출할 때 증가합니다.

설명

지정된 구성 요소에 대한 VSS_COMPONENTINFO 개체를 가져오려면 요청자는 먼저 IVssExamineWriterMetadata::GetComponent 호출을 통해 해당 IVssWMComponent 개체를 가져와야 합니다. IVssWMComponent::GetComponentInfo에 대한 호출은 VSS_COMPONENTINFO 구조를 할당하고 반환합니다.

VSS_COMPONENTINFOIVssWMComponent::GetComponentInfo에 의해 할당되고 반환되므로 요청자는 VSS_COMPONENTINFO 개체를 직접 해제하지 말고 IVssWMComponent::FreeComponentInfo를 사용해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
머리글	vsbackup.h(VsBackup.h, Vss.h, VsWriter.h 포함)