Fungsi SisRestoredLink

Fungsi SisRestoredLink mengembalikan nama file atau file penyimpanan umum yang diacu oleh tautan SIS yang dipulihkan yang ditentukan.

Sintaks

BOOL SisRestoredLink(
  _In_  PVOID  sisRestoreStructure,
  _In_  PWCHAR restoredFileName,
  _In_  PVOID  reparseData,
  _In_  ULONG  reparseDataSize,
  _Out_ PULONG countOfCommonStoreFilesToRestore,
  _Out_ PWCHAR **commonStoreFilesToRestore
);

Parameter

sisRestoreStructure [in]

Pointer ke struktur pemulihan SIS yang dikembalikan dari SisCreateRestoreStructure.

restoredFileName [in]

Nama file yang sepenuhnya memenuhi syarat dari file tautan SIS yang dipulihkan.

reparseData [in]

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

reparseDataSize [in]

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

countOfCommonStoreFilesToRestore [out]

Jumlah file yang tercantum dalam parameter commonStoreFilesToRestore .

commonStoreFilesToRestore [out]

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

Jika nilai parameter countOfCommonStoreFilesToRestore bukan 0, nilai parameter commonStoreFilesToRestore akan berisi nama file penyimpanan umum yang akan dipulihkan sebagai hasil dari memulihkan tautan SIS. Jika nilainya adalah 0, maka file penyimpanan umum telah dikembalikan sekali, atau sudah ada pada volume.

Mengembalikan nilai

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

Keterangan

Anda harus memanggil fungsi ini untuk setiap tautan SIS yang telah dipulihkan.

Fungsi ini akan mengembalikan setiap file penyimpanan umum paling banyak sekali untuk setiap operasi pemulihan; setiap upaya untuk memulihkan tautan SIS tambahan yang melihat file penyimpanan umum yang sama tidak akan mengakibatkan nama file penyimpanan umum dikembalikan.

Fungsi ini tidak akan mengembalikan file penyimpanan umum yang tidak juga dikembalikan dalam panggilan ke SisCSFilesToBackupForLink selama operasi pencadangan, dengan asumsi bahwa data pemisahan ulang SIS yang disimpan di media belum rusak.

Saat memulihkan tautan SIS, operasi pemulihan Anda hanya harus membuat file jarang yang sesuai, menginisialisasi rentang yang dialokasikan, lalu menulis data pemisahan ulang SIS persis seperti yang dibaca selama operasi pencadangan. Sangat penting bahwa operasi pemulihan Anda membuat file jarang dengan rentang yang tidak dialokasikan daripada file jarang (atau file nonsparse) yang diinisialisasi dengan nol.

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.

Persyaratan

Lihat juga

SisCreateRestoreStructure

SisCSFilesToBackupForLink