SisCreateRestoreStructure 함수

SisCreateRestoreStructure 함수는 제공된 정보를 기반으로 SIS 복원 구조를 만듭니다.

구문

BOOL SisCreateRestoreStructure(
  _In_  PWCHAR volumeRoot,
  _Out_ PVOID  *sisRestoreStructure,
  _Out_ PWCHAR *commonStoreRootPathname,
  _Out_ PULONG countOfCommonStoreFilesToRestore,
  _Out_ PWCHAR **commonStoreFilesToRestore
);

매개 변수

volumeRoot [in]

백업할 볼륨의 후행 백슬래시가 없는 볼륨 루트의 파일 이름입니다. 예를 들어 "C:\"가 아닌 "C:"를 지정합니다. 볼륨은 시스템 또는 부팅 볼륨일 수 없습니다.

sisRestoreStructure [out]

반환된 SIS 복원 구조입니다. 이 구조체는 호출자가 불투명하게 처리해야 합니다.

commonStoreRootPathname [out]

지정된 볼륨의 공통 저장소에 대한 정규화된 경로 이름입니다. 예를 들어 "c:\SIS Common Store"가 있습니다.

countOfCommonStoreFilesToRestore [out]

commonStoreFilesToRestore 매개 변수에 나열된 파일 수입니다.

commonStoreFilesToRestore [out]

SIS에서 지정된 볼륨을 관리하는 데 사용하는 내부 파일 목록을 지정하는 파일 이름 배열에 대한 포인터입니다. 이러한 파일은 SisCSFilesToBackupForLink에서 요청한 공통 저장소 파일과 동일한 방식으로 동시에 복원해야 합니다.

반환 값

이 함수는 성공적으로 완료되면 TRUE 를 반환하고 그렇지 않으면 FALSE 를 반환합니다. GetLastError를 호출하여 호출이 실패한 이유에 대한 자세한 정보를 가져옵니다.

설명

이 함수는 SisCreateBackupStructure 가 지정된 볼륨에 백업 환경을 설정하는 방식으로 지정된 볼륨에서 복원 환경을 설정합니다.

이 함수는 공통 저장소 파일 또는 파일이 여전히 디스크에 있는 경우 백업 미디어의 SIS 링크 집합에 해당하는 공통 저장소 파일 또는 파일을 반드시 식별하지는 않습니다. 공통 저장소 파일의 데이터 스트림의 내용은 생성된 후에는 변경되지 않으므로 디스크에 파일이 이미 있는 경우 복원할 필요가 없습니다.

일반 저장소 파일 이름은 백업 작업에서 액세스한 것과 동일한 SIS 사용 볼륨에서 발생하지 않더라도 복원 작업의 무결성을 보장하기 위해 전역적으로 고유합니다.

복원 작업이 완료되면 SisFreeAllocatedMemory를 호출하여 문자열의 commonStoreFilesToRestore 배열에서 사용하는 메모리의 할당을 취소합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
헤더	Sisbkup.h
라이브러리	Sisbkup.lib
DLL	Sisbkup.dll

추가 정보

SisCreateBackupStructure

SisCSFilesToBackupForLink

SisFreeAllocatedMemory

SisFreeBackupStructure