Fungsi SisCreateBackupStructure

Artikel
06/03/2023

Fungsi SisCreateBackupStructure membuat struktur cadangan SIS berdasarkan informasi yang disediakan.

Sintaks

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

Parameter

volumeRoot [in]: Nama file akar volume, tanpa garis miring terbalik berikutnya, dari volume yang akan dicadangkan. Misalnya, tentukan "C:" dan bukan "C:\".
sisBackupStructure [out]: Struktur cadangan SIS yang dikembalikan.
commonStoreRootPathname [out]: Nama jalur yang sepenuhnya memenuhi syarat dari penyimpanan umum volume yang ditentukan. Misalnya, "c:\SIS Common Store".
countOfCommonStoreFilesToBackUp [out]: Jumlah file yang tercantum dalam parameter commonStoreFilesToBackUp .
commonStoreFilesToBackUp [out]: Penunjuk ke array nama file yang menentukan daftar file internal yang digunakan oleh SIS untuk mengelola volume yang ditentukan. File-file ini harus dicadangkan 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 membuat struktur cadangan SIS, yang digunakan oleh API cadangan SIS untuk membuat dan memelihara daftar tautan file pada volume dan file asli yang dirujuk tautan. Fungsi ini harus dipanggil hanya sekali untuk setiap volume yang diaktifkan SIS yang dicadangkan. Semua file dalam volume yang ditentukan harus diperlakukan sebagai file penyimpanan umum dan dicadangkan hanya jika SIS menunjukkan bahwa mereka harus.

Parameter countOfCommonStoreFilesToBackUp dan commonStoreFilesToBackUp bersama-sama mengembalikan daftar file yang harus dicadangkan terlepas dari tautan mana yang dicadangkan.

Jika countOfCommonStoreFilesToBackUp adalah 0, commonStoreFilesToBackUp mungkin merupakan penunjuk NULL . Nilai parameter commonStoreFilesToBackUp harus diabaikan.

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	Sisbkup.h
Pustaka	Sisbkup.lib
DLL	Sisbkup.dll

Lihat juga

SisCreateRestoreStructure
SisCSFilesToBackupForLink
SisFreeAllocatedMemory

Bagikan melalui