Export (0) Print
Expand All

SisCreateRestoreStructure function

The SisCreateRestoreStructure function creates a SIS restore structure based on the supplied information.

Syntax


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

Parameters

volumeRoot [in]

File name of the volume root, without the trailing backslash, of the volume to be backed up. For example, specify "C:" and not "C:\". The volume cannot be the system or boot volume.

sisRestoreStructure [out]

Returned SIS restore structure. This structure should be treated as opaque by the caller.

commonStoreRootPathname [out]

Fully qualified path name of the specified volume's common store. For example, "c:\SIS Common Store".

countOfCommonStoreFilesToRestore [out]

Number of files listed in the commonStoreFilesToRestore parameter.

commonStoreFilesToRestore [out]

Pointer to an array of file names that specifies the list of internal files used by SIS to manage the specified volume. These files should be restored at the same time and in the same manner as the common-store files requested by SisCSFilesToBackupForLink.

Return value

This function returns TRUE if it completes successfully and FALSE otherwise. Call GetLastError to get more information about the reason the call failed.

Remarks

This function establishes the restore environment on the specified volume in the way that SisCreateBackupStructure establishes the backup environment on the specified volume.

Note that this function will not necessarily identify the common-store file or files corresponding to a set of SIS links on the backup media if those common store file or files still exist on disk. The contents of a common-store file's data stream never change once it is created, so if the file already exists on the disk there is no need to restore it.

Common-store file names are globally unique to ensure the integrity of the restore operation even if it does not occur on the same SIS-enabled volume that the backup operation has accessed.

After the restore operation is complete, deallocate the memory used by the commonStoreFilesToRestore array of strings by calling SisFreeAllocatedMemory.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Sisbkup.h

Library

Sisbkup.lib

DLL

Sisbkup.dll

See also

SisCreateBackupStructure
SisCSFilesToBackupForLink
SisFreeAllocatedMemory
SisFreeBackupStructure

 

 

Community Additions

ADD
Show:
© 2014 Microsoft