Fungsi SisCSFilesToBackupForLink

Fungsi SisCSFilesToBackupForLink mengembalikan informasi yang menjelaskan file penyimpanan umum yang ditunjukkan tautan SIS yang ditentukan.

Sintaks

BOOL SisCSFilesToBackupForLink(
  _In_  PVOID  sisBackupStructure,
  _In_  PVOID  reparseData,
  _In_  ULONG  reparseDataSize,
  _Out_ PVOID  thisFileContext,
  _Out_ PVOID  *matchingFileContext,
  _Out_ PULONG countOfCommonStoreFilesToBackUp,
  _Out_ PWCHAR **commonStoreFilesToBackUp
);

Parameter

sisBackupStructure [in]

Penunjuk ke struktur cadangan SIS yang dikembalikan dari SisCreateBackupStructure.

reparseData [in]

Arahkan ke konten titik reparse SIS. Titik pemisahan ulang ini berisi data yang menjelaskan tautan SIS. Untuk mengambil data titik pemilah ulang untuk file, gunakan kode kontrol FSCTL_GET_REPARSE_POINT .

reparseDataSize [in]

Ukuran konten titik pemisahan ulang SIS yang diacu oleh reparseData, dalam byte.

thisFileContext [out]

Penunjuk ke string konteks yang disediakan oleh aplikasi cadangan yang memanggil fungsi ini. Konten string konten ini sepenuhnya ditentukan oleh aplikasi cadangan ini dan tidak ditafsirkan oleh SIS Backup API. Parameter ini bersifat opsional; jika tidak digunakan, atur nilai parameter ini ke NULL. Nilai parameter ini tidak akan diproses dalam kasus ini.

matchingFileContext [out]

Penunjuk tidak langsung dua kali ke string konteks tautan SIS yang diidentifikasi oleh informasi yang diteruskan dalam empat parameter pertama fungsi ini. Parameter ini bersifat opsional; jika string konteks tidak disediakan sebagai nilai parameter thisFileContext , atur nilai parameter ini ke NULL. Nilai parameter ini tidak akan diproses dalam kasus ini.

countOfCommonStoreFilesToBackUp [out]

Jumlah file yang tercantum dalam parameter commonStoreFilesToBackUp .

commonStoreFilesToBackUp [out]

Penunjuk ke array nama file. File-file ini harus dicadangkan pada saat yang sama dan dengan cara yang sama seperti file penyimpanan umum yang diminta oleh SisCreateBackupStructure.

Mengembalikan nilai

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

Keterangan

Aplikasi cadangan harus memanggil fungsi ini hanya sekali untuk setiap file tautan SIS yang dicadangkan.

Aplikasi cadangan dapat mengidentifikasi titik pemisahan ulang SIS dengan tagnya, IO_REPARSE_TAG_SIS. Tag ini didefinisikan dalam Winnt.h.

Jika titik pemilahan ulang ini diidentifikasi oleh nilai parameter reparseData menjelaskan instans pertama file yang akan dicadangkan, fungsi ini akan mengembalikan NULL sebagai nilai parameter matchingFileContext , dan menginisialisasi nilai array string commonStoreFilesToBackUp dengan nama file atau file penyimpanan umum yang akan dicadangkan. Jika tidak, fungsi ini akan mengatur nilai parameter matchingFileContext ke string konteks yang sesuai dengan instans pertama dari file yang ditentukan dan mengatur nilai parameter countOfCommonStoreFilesToBackUp ke 0. Jika ada beberapa file penyimpanan umum yang sesuai dengan tautan yang ditentukan, nilai parameter thisFileContext akan menjadi string konteks yang sesuai dengan file penyimpanan umum pertama yang dikembalikan dalam array yaitu, commonStoreFilesToBackUp[0].

Versi fungsi ini saat ini akan mengembalikan paling banyak satu file penyimpanan umum, tetapi ada kemungkinan bahwa di versi mendatang satu tautan dapat didukung oleh beberapa file penyimpanan umum misalnya, satu untuk setiap aliran dalam file sehingga aplikasi cadangan Anda harus mendukung beberapa file di setiap panggilan ke fungsi ini. Bagaimanapun, setiap file penyimpanan umum akan dikembalikan paling banyak sekali untuk setiap lulus cadangan.

Aplikasi cadangan Anda harus mencadangkan atau memulihkan file atau file penyimpanan umum yang diidentifikasi dengan nama file atau nama file yang dikembalikan dalam parameter commonStoreFilesToBackUp . Terlepas dari apakah ada file penyimpanan umum yang sesuai, aplikasi cadangan Anda harus mencadangkan file tautan SIS seperti yang ada di disk misalnya, sebagai titik pemisahan ulang dan file jarang, dan kemungkinan besar tanpa rentang yang terisi. Aplikasi cadangan Anda dapat mencadangkan atau memulihkan file atau file penyimpanan umum segera, menunda pencadangannya, atau mencampurnya bersama-sama seperlunya.

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

Persyaratan

Lihat juga

SisFreeAllocatedMemory

SisCreateBackupStructure