IVssCreateExpressWriterMetadata::AddFilesToFileGroup 메서드(vswriter.h)
빠른 작성기에 대해 지정된 파일 그룹 구성 요소에 파일 집합(지정된 파일 또는 파일)을 추가합니다.
구문
HRESULT AddFilesToFileGroup(
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszGroupName,
[in] LPCWSTR wszPath,
[in] LPCWSTR wszFilespec,
[in] bool bRecursive,
[in] LPCWSTR wszAlternateLocation,
[in] DWORD dwBackupTypeMask
);
매개 변수
[in] wszLogicalPath
파일을 추가할 구성 요소의 논리 경로( NULL일 수 있음)를 포함하는 null로 끝나는 와이드 문자열에 대한 포인터입니다. 자세한 내용은 구성 요소의 논리적 경로를 참조하세요.
[in] wszGroupName
파일 그룹 구성 요소의 이름을 포함하는 null로 끝나는 와이드 문자열에 대한 포인터입니다. 이 구성 요소의 형식은 VSS_CT_FILEGROUP 합니다. 그렇지 않으면 메서드가 오류를 반환합니다.
[in] wszPath
추가할 파일의 기본 루트 디렉터리를 포함하는 null로 끝나는 와이드 문자열에 대한 포인터입니다.
경로에는 환경 변수(예: %SystemRoot%)가 포함될 수 있지만 와일드카드 문자를 포함할 수는 없습니다.
경로가 백슬래시(\)로 끝나야 한다는 요구 사항은 없습니다. 검사 이 정보를 검색하는 것은 애플리케이션에 달려 있습니다.
[in] wszFilespec
포함할 파일의 파일 사양을 포함하는 null로 끝나는 와이드 문자열에 대한 포인터입니다.
파일 사양에는 디렉터리 사양(예: 백 슬래시 없음)을 포함할 수 없지만 ? 및 * 와일드카드 문자입니다.
[in] bRecursive
wszPath 매개 변수로 지정된 경로가 단일 디렉터리만 식별하는지 또는 재귀적으로 트래버스할 디렉터리의 계층 구조를 나타내는지 여부를 지정하는 부울 값입니다. 경로가 재귀할 디렉터리의 계층 구조로 처리되거나 그렇지 않으면 false인 경우 이 매개 변수를 true로 설정해야 합니다.
탑재된 폴더를 트래버스하는 방법에 대한 자세한 내용은 탑재된 폴더 작업 및 지점 재분석을 참조하세요.
[in] wszAlternateLocation
이 매개 변수는 예약되어 있으며 NULL이어야 합니다.
[in] dwBackupTypeMask
기록기가 특정 유형의 백업 작업에 참여하기 위해 파일을 평가해야 하는지 여부를 나타내는 VSS_FILE_SPEC_BACKUP_TYPE 열거형 값의 비트 마스크입니다.
이 매개 변수에는 VSS_FSBT_DIFFERENTIAL_BACKUP_REQUIRED, VSS_FSBT_INCREMENTAL_BACKUP_REQUIRED 또는 VSS_FSBT_LOG_BACKUP_REQUIRED 포함될 수 없습니다.
이 인수의 기본값은 (VSS_FSBT_ALL_BACKUP_REQUIRED | VSS_FSBT_ALL_SNAPSHOT_REQUIRED).
반환 값
다음은 이 메서드에 대한 유효한 반환 코드입니다.
| 값 | 의미 |
|---|---|
|
작업이 완료되었습니다. |
|
매개 변수 값 중 하나가 잘못되었거나 호출자가 파일 그룹 이외의 구성 요소에 파일 그룹 파일을 추가하려고 했습니다. |
|
호출자가 메모리가 부족하거나 다른 시스템 리소스가 부족합니다. |
|
XML 문서가 잘못되었습니다. 자세한 내용은 이벤트 로그를 확인합니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요. |
|
지정된 구성 요소가 없습니다. |
|
예기치 않은 오류입니다. 오류 코드가 오류 로그 파일에 기록됩니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요.
Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 값은 Windows Server 2008 R2 및 Windows 7까지 지원되지 않습니다. 대신 E_UNEXPECTED 사용됩니다. |
요구 사항
| 지원되는 최소 클라이언트 | Windows 7 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 R2 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | vswriter.h(Vss.h, VsWriter.h 포함) |
| 라이브러리 | VssApi.lib |