Fungsi SisCreateRestoreStructure

Fungsi SisCreateRestoreStructure membuat struktur pemulihan SIS berdasarkan informasi yang disediakan.

Sintaks

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

Parameter

volumeRoot [in]

Nama file akar volume, tanpa garis miring terbalik berikutnya, dari volume yang akan dicadangkan. Misalnya, tentukan "C:" dan bukan "C:\". Volume tidak boleh berupa sistem atau volume boot.

sisRestoreStructure [out]

Struktur pemulihan SIS yang dikembalikan. Struktur ini harus diperlakukan sebagai buram oleh pemanggil.

commonStoreRootPathname [out]

Nama jalur yang sepenuhnya memenuhi syarat dari penyimpanan umum volume yang ditentukan. Misalnya, "c:\SIS Common Store".

countOfCommonStoreFilesToRestore [out]

Jumlah file yang tercantum dalam parameter commonStoreFilesToRestore .

commonStoreFilesToRestore [out]

Penunjuk ke array nama file yang menentukan daftar file internal yang digunakan oleh SIS untuk mengelola volume yang ditentukan. File-file ini harus dipulihkan pada saat yang sama dan dengan cara yang sama seperti file penyimpanan umum yang diminta oleh SisCSFilesToBackupForLink.

Mengembalikan nilai

Fungsi ini mengembalikan TRUE jika berhasil diselesaikan dan FALSE sebaliknya. Hubungi GetLastError untuk mendapatkan informasi selengkapnya tentang alasan panggilan gagal.

Keterangan

Fungsi ini menetapkan lingkungan pemulihan pada volume yang ditentukan dengan cara SisCreateBackupStructure menetapkan lingkungan cadangan pada volume yang ditentukan.

Perhatikan bahwa fungsi ini tidak akan selalu mengidentifikasi file atau file penyimpanan umum yang sesuai dengan sekumpulan tautan SIS di media cadangan jika file atau file penyimpanan umum tersebut masih ada di disk. Konten aliran data file penyimpanan umum tidak pernah berubah setelah dibuat, jadi jika file sudah ada di disk, tidak perlu memulihkannya.

Nama file penyimpanan umum unik secara global untuk memastikan integritas operasi pemulihan meskipun tidak terjadi pada volume berkemampuan SIS yang sama dengan yang telah diakses oleh operasi pencadangan.

Setelah operasi pemulihan selesai, batalkan alokasi memori yang digunakan oleh array string commonStoreFilesToRestore dengan memanggil SisFreeAllocatedMemory.

Persyaratan

Lihat juga

SisCreateBackupStructure

SisCSFilesToBackupForLink

SisFreeAllocatedMemory

SisFreeBackupStructure