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

복원 작업이 완료된 후 다시 부팅이 필요한지 여부를 나타내는 부울 값입니다.

반환 값

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

값	의미
S_OK	작업이 완료되었습니다.
E_INVALIDARG	매개 변수 값 중 하나가 잘못되었습니다.
E_OUTOFMEMORY	호출자가 메모리가 부족하거나 다른 시스템 리소스가 부족합니다.
VSS_E_INVALID_XML_DOCUMENT	XML 문서가 잘못되었습니다. 자세한 내용은 이벤트 로그를 확인합니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요.
VSS_E_UNEXPECTED	예기치 않은 오류입니다. 오류 코드가 오류 로그 파일에 기록됩니다. 자세한 내용은 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

추가 정보

IVssCreateExpressWriterMetadata