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

아티클
08/27/2023

백업할 빠른 작성기의 구성 요소 집합에 파일 그룹을 추가합니다.

구문

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입니다.

반환 값

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

값	의미
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 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	vswriter.h(Vss.h, VsWriter.h 포함)
라이브러리	VssApi.lib

추가 정보

IVssCreateExpressWriterMetadata

Share via

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

구문

매개 변수

반환 값

설명

요구 사항

추가 정보

피드백

피드백

추가 리소스