IVssCreateExpressWriterMetadata::SetRestoreMethod 메서드(vswriter.h)
빠른 기록기 데이터를 복원하는 방법을 지정합니다.
구문
HRESULT SetRestoreMethod(
[in] VSS_RESTOREMETHOD_ENUM method,
[in] LPCWSTR wszService,
[in] LPCWSTR wszUserProcedure,
[in] VSS_WRITERRESTORE_ENUM writerRestore,
[in] bool bRebootRequired
);
매개 변수
[in] method
복원 작업에 사용할 복원 방법을 지정하는 VSS_RESTOREMETHOD_ENUM 열거형 값입니다. 이 매개 변수는 필수이며 VSS_RME_UNDEFINED, VSS_RME_RESTORE_TO_ALTERNATE_LOCATION 또는 VSS_RME_CUSTOM 수 없습니다.
[in] wszService
메서드 값이 VSS_RME_STOP_RESTORE_START 또는 VSS_RME_RESTORE_STOP_START 경우 복원 작업 전에 중지한 다음 복원 작업이 수행된 후 시작해야 하는 서비스의 이름을 포함하는 와이드 문자열에 대한 포인터입니다.
메서드 값이 VSS_RME_STOP_RESTORE_START 아니거나 VSS_RME_RESTORE_STOP_START 경우 이 매개 변수는 사용되지 않으며 NULL로 설정해야 합니다.
[in] wszUserProcedure
다음에 사용하도록 예약됩니다. 이 매개 변수의 값은 항상 NULL로 설정해야 합니다.
[in] writerRestore
기록기가 데이터 복원에 참여할지 여부를 지정하는 VSS_WRITERRESTORE_ENUM 열거형 값입니다. 이 매개 변수는 VSS_WRE_NEVER 설정해야 합니다.
[in] bRebootRequired
복원 작업이 완료된 후 다시 부팅이 필요한지 여부를 나타내는 부울 값입니다.
반환 값
다음은 이 메서드에 대한 유효한 반환 코드입니다.
| 값 | 의미 |
|---|---|
|
작업이 완료되었습니다. |
|
매개 변수 값 중 하나가 잘못되었습니다. |
|
호출자가 메모리가 부족하거나 다른 시스템 리소스가 부족합니다. |
|
XML 문서가 잘못되었습니다. 자세한 내용은 이벤트 로그를 확인합니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요. |
|
예기치 않은 오류입니다. 오류 코드가 오류 로그 파일에 기록됩니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요.
Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 값은 Windows Server 2008 R2 및 Windows 7까지 지원되지 않습니다. 대신 E_UNEXPECTED 사용됩니다. |
설명
빠른 작성기는 하나의 복원 방법만 정의할 수 있습니다. restore 메서드를 재정의하지 않으면 동일한 메서드를 사용하여 모든 빠른 작성기의 구성 요소가 복원됩니다.
Express 기록기는 일반적으로 PreRestore 이벤트(CVssWriter::OnPreRestore)를 처리하는 동안 복원 대상을 설정하여 구성 요소별로 복원 메서드를 재정의합니다.
복원 메서드가 작성기별로 적용되더라도 메서드는 구성 요소별로 구현됩니다. 예를 들어 메서드 매개 변수로 지정된 메서드가 VSS_RME_RESTORE_IF_CAN_REPLACE 경우 오류가 발생하지 않고 모두 바꿀 수 있는 경우 구성 요소의 모든 파일이 원래 위치로 복원됩니다. 그렇지 않으면 지정된 경우 대체 위치로 복원됩니다.
다음 중 하나가 true인 경우 파일을 대체 위치 매핑으로 복원할 수 있습니다.
- 복원 방법은 VSS_RME_RESTORE_IF_NOT_THERE 파일 버전이 디스크에 이미 있습니다.
- restore 메서드는 VSS_RME_RESTORE_IF_CAN_REPLACE 파일 버전이 디스크에 있으며 바꿀 수 없습니다.
복원 방법에 대한 자세한 내용은 VSS 복원 메서드 설정을 참조하세요.
restore 메서드가 VSS_RME_STOP_RESTORE_START 또는 VSS_RME_RESTORE_STOP_START 경우 서비스의 올바른 이름을 wszService 인수로 제공해야 합니다. 복원 작업 중 서비스 중지 및 다시 시작에 대한 기록기 참여에 대한 자세한 내용은 요청자에 의한 복원을 위한 서비스 중지를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 R2 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | vswriter.h(Vss.h, VsWriter.h 포함) |
| 라이브러리 | VssApi.lib |