IVssCreateExpressWriterMetadata::AddComponent 메서드(vswriter.h)
백업할 빠른 작성기의 구성 요소 집합에 파일 그룹을 추가합니다.
구문
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 열거형 값입니다. 이 매개 변수에는 VSS_CT_FILEGROUP 만 지원됩니다.
[in] wszLogicalPath
데이터베이스 또는 파일 그룹의 논리적 경로를 포함하는 null로 끝나는 와이드 문자열에 대한 포인터입니다. 자세한 내용은 구성 요소의 논리적 경로를 참조하세요.
이 매개 변수는 선택 사항이며 NULL일 수 있습니다.
[in] wszComponentName
구성 요소의 이름을 포함하는 null로 끝나는 와이드 문자열에 대한 포인터입니다. 이 문자열은 지역화되지 않았습니다.
이 매개 변수는 필수이며 NULL일 수 없습니다. 문자열은 백슬라이시를 포함할 수 없습니다.
[in] wszCaption
구성 요소에 대한 설명("식별 이름"이라고도 함)이 포함된 null로 끝나는 와이드 문자열에 대한 포인터입니다. 이 문자열은 지역화될 수 있으므로 요청자는 지역화되어 있다고 가정해야 합니다.
이 매개 변수는 선택 사항이며 NULL일 수 있습니다. 문자열에는 백슬라쉬가 포함될 수 있습니다.
[in] pbIcon
사용자 인터페이스에 표시할 데이터베이스를 나타내는 아이콘의 비트맵에 대한 포인터입니다. 버퍼의 크기(바이트)는 cbIcon 매개 변수에 의해 지정됩니다.
이 매개 변수는 선택 사항이며 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 열거형 값의 비트 마스크입니다. 이 비트 마스크에는 VSS_CF_APP_ROLLBACK_RECOVERY 또는 VSS_CF_BACKUP_RECOVERY 포함될 수 없습니다.
이 매개 변수의 기본값은 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 7 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 R2 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | vswriter.h(Vss.h, VsWriter.h 포함) |
| 라이브러리 | VssApi.lib |