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