SisCreateBackupStructure 함수

SisCreateBackupStructure 함수는 제공된 정보를 기반으로 SIS 백업 구조를 만듭니다.

구문

BOOL SisCreateBackupStructure(
  _In_  PWCHAR volumeRoot,
  _Out_ PVOID  *sisBackupStructure,
  _Out_ PWCHAR *commonStoreRootPathname,
  _Out_ PULONG countOfCommonStoreFilesToBackUp,
  _Out_ PWCHAR **commonStoreFilesToBackUp
);

매개 변수

volumeRoot [in]

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

sisBackupStructure [out]

반환된 SIS 백업 구조.

commonStoreRootPathname [out]

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

countOfCommonStoreFilesToBackUp [out]

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

commonStoreFilesToBackUp [out]

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

반환 값

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

설명

이 함수는 SIS 백업 API에서 링크가 가리키는 볼륨 및 원래 파일의 파일 링크 목록을 만들고 유지 관리하는 데 사용되는 SIS 백업 구조를 만듭니다. 이 함수는 백업되는 각 SIS 사용 볼륨에 대해 한 번만 호출해야 합니다. 지정된 볼륨 내의 모든 파일은 공통 저장소 파일로 처리되고 SIS가 해당 파일을 사용해야 한다고 나타내는 경우에만 백업해야 합니다.

countOfCommonStoreFilesToBackUp 및 commonStoreFilesToBackUp 매개 변수는 백업되는 링크에 관계없이 백업해야 하는 파일 목록을 함께 반환합니다.

countOfCommonStoreFilesToBackUp이 0이면 commonStoreFilesToBackUp이 NULL 포인터일 수 있습니다. commonStoreFilesToBackUp 매개 변수의 값은 무시해야 합니다.

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

요구 사항

추가 정보

SisCreateRestoreStructure

SisCSFilesToBackupForLink

SisFreeAllocatedMemory