IVssCreateWriterMetadata::AddComponent 메서드(vswriter.h)

  • 아티클

AddComponent 메서드는 백업할 구성 요소로 데이터베이스 또는 파일 그룹을 추가합니다.

구문

HRESULT AddComponent(
  [in] VSS_COMPONENT_TYPE ct,
  [in] LPCWSTR            wszLogicalPath,
  [in] LPCWSTR            wszComponentName,
  [in] LPCWSTR            wszCaption,
  [in] const BYTE         *pbIcon,
  [in] UINT               cbIcon,
  [in] bool               bRestoreMetadata,
  [in] bool               bNotifyOnBackupComplete,
  [in] bool               bSelectable,
  [in] bool               bSelectableForRestore,
  [in] DWORD              dwComponentFlags
);

매개 변수

[in] ct

구성 요소의 형식을 지정하는 VSS_COMPONENT_TYPE 열거형 값입니다.

Windows Server 2003 및 Windows XP: WINDOWS Server 2003 SP1 이전에는 이 매개 변수가 시스템 사용을 위해 예약되어 있으며 호출자는 기본값을 재정의해서는 안 됩니다.

[in] wszLogicalPath

데이터베이스 또는 파일 그룹의 논리적 경로를 포함하는 null로 끝나는 와이드 문자열에 대한 포인터입니다. 자세한 내용은 구성 요소의 논리적 경로를 참조하세요.

논리 경로는 선택 사항이며 NULL일 수 있습니다.

[in] wszComponentName

구성 요소의 이름을 포함하는 null로 끝나는 와이드 문자열에 대한 포인터입니다. 이 문자열은 지역화되지 않습니다.

이 매개 변수는 필수이며 NULL일 수 없습니다. 문자열은 백슬라이시를 포함할 수 없습니다.

[in] wszCaption

구성 요소에 대한 설명("식별 이름"이라고도 함)이 포함된 null로 끝나는 와이드 문자열에 대한 포인터입니다. 이 문자열은 지역화될 수 있으므로 요청자는 지역화되어 있다고 가정해야 합니다.

이 매개 변수는 선택 사항이며 NULL일 수 있습니다. 문자열은 백슬라이시를 포함할 수 있습니다.

[in] pbIcon

사용자 인터페이스에 표시할 데이터베이스를 나타내는 아이콘의 비트맵에 대한 포인터입니다. 버퍼의 크기(바이트)는 cbIcon 매개 변수에 의해 지정됩니다.

작성기에서 아이콘을 지정하지 않으려면 pbIcon 을 NULL로 설정해야 합니다.

[in] cbIcon

버퍼의 크기(바이트)입니다. pbIcon 매개 변수가 NULL인 경우 cbIcon은 0이어야 합니다.

[in] bRestoreMetadata

이 매개 변수는 나중에 사용할 수 있도록 예약되어 있으며 항상 false로 설정해야 합니다.

[in] bNotifyOnBackupComplete

이 매개 변수는 나중에 사용할 수 있도록 예약되어 있으며 항상 false로 설정해야 합니다.

[in] bSelectable

구성 요소를 선택적으로 백업할 수 있는지(즉, 백업에서 제외할 수 있음) 또는 기록기의 구성 요소가 백업될 때 항상 백업되는지 여부를 나타내는 부울입니다. 구성 요소를 선택적으로 백업할 수 있으면 부울이 true 이고 구성 요소가 백업될 때 백업되면 false 입니다.

[in] bSelectableForRestore

백업 문서에 명시적으로 포함되지 않은 경우 구성 요소를 개별적으로 복원할 수 있는지 여부를 결정하는 부울입니다. 구성 요소가 백업 문서에 명시적으로 추가된 경우 복원을 위해 항상 개별적으로 선택할 수 있습니다. 이 경우 이 플래그는 의미가 없습니다.

true이면 구성 요소 자체를 복원할 수 있습니다. false이면 전체 구성 요소 집합이 복원되는 경우에만 구성 요소를 복원할 수 있습니다. 자세한 내용은 VSS_COMPONENTINFO 및 선택 가능성 및 논리 경로 작업을 참조하세요 .

이 매개 변수의 기본값은 false입니다.

[in] dwComponentFlags

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

이 인수의 기본값은 0입니다.

반환 값

다음은 이 메서드에 대한 유효한 반환 코드입니다.

값 의미
S_OK
 작업이 완료되었습니다.
E_INVALIDARG
 매개 변수 값 중 하나가 잘못되었습니다.
E_OUTOFMEMORY
 호출자가 메모리가 부족하거나 다른 시스템 리소스가 부족합니다.
VSS_E_INVALID_XML_DOCUMENT
 XML 문서가 잘못되었습니다. 자세한 내용은 이벤트 로그를 확인합니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요.
VSS_E_OBJECT_ALREADY_EXISTS
 개체가 중복된 경우 동일한 논리 경로와 구성 요소 이름을 가진 구성 요소가 이미 있습니다.
VSS_E_UNEXPECTED
 예기치 않은 오류입니다. 오류 코드가 오류 로그 파일에 기록됩니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 값은 Windows Server 2008 R2 및 Windows 7까지 지원되지 않습니다. E_UNEXPECTED 대신 사용됩니다.

설명

이 메서드를 여러 번 호출하여 기록기 메타데이터에 여러 구성 요소를 추가할 수 있습니다.

지정된 작성기 클래스의 지정된 instance 각 구성 요소에 대한 논리 경로와 이름의 조합은 고유해야 합니다. wszLogicalPath 및 wszComponentName의 동일한 값으로 AddComponent를 두 번 호출하려고 시도하면 VSS_E_OBJECT_ALREADY_EXISTS 오류가 발생합니다.

AddComponent 를 사용하여 하위 구성 요소를 추가할 수 있습니다. 모든 멤버 파일이 그룹으로 백업되지만 개별적으로 복원할 수 있는 파일이 포함된 구성 요소입니다. 자세한 내용은 복원 및 하위 구성 요소에 대한 선택 가능성 작업을 참조하세요 .

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 vswriter.h(Vss.h, VsWriter.h 포함)
라이브러리 VssApi.lib

추가 정보

IVssCreateWriterMetadata