Metode IVssHardwareSnapshotProvider::OnLunEmpty (vsprov.h)

  • Artikel

Metode OnLunEmpty dipanggil setiap kali VSS menentukan bahwa LUN salinan bayangan tidak berisi data yang menarik. Semua salinan bayangan telah dihapus (yang juga menyebabkan penghapusan LUN.) Sumber daya LUN dapat diklaim kembali oleh penyedia dan digunakan kembali untuk tujuan lain. VSS akan melepas volume yang terpengaruh. Penyedia tidak boleh mengeluarkan pindaian ulang selama OnLunEmpty. VSS akan menangani pembersihan ini.

Catatan Penyedia perangkat keras hanya didukung pada sistem operasi Windows Server.
 

Sintaks

HRESULT OnLunEmpty(
  [in] VSS_PWSZ            wszDeviceName,
  [in] VDS_LUN_INFORMATION *pInformation
);

Parameter

[in] wszDeviceName

Perangkat yang sesuai dengan LUN yang berisi salinan bayangan yang akan dihapus.

[in] pInformation

Penunjuk ke struktur VDS_LUN_INFORMATION yang berisi informasi tentang LUN yang berisi salinan bayangan yang akan dihapus.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Mengembalikan kode/nilai Deskripsi
S_OK
0x00000000L
 Operasi berhasil diselesaikan.
E_OUTOFMEMORY
0x8007000EL
 Kehabisan memori atau sumber daya sistem lainnya.
E_INVALIDARG
0x80070057L
 Salah satu nilai parameter tidak valid.
VSS_E_PROVIDER_VETO
0x80042306L
 Terjadi kesalahan penyedia tak terduga. Penyedia harus melaporkan peristiwa di log peristiwa aplikasi yang memberi pengguna informasi tentang cara menyelesaikan masalah.

Keterangan

Penyedia perangkat keras harus menghapus salinan bayangan dan mengklaim kembali LUN jika dan hanya jika
OnLunEmpty sedang dipanggil. Salinan bayangan perangkat keras dapat digunakan sebagai media cadangan itu sendiri, oleh karena itu LUN harus diperlakukan dengan perawatan yang sama array penyimpanan memperlakukan LUN yang digunakan untuk disk reguler. Mengklaim kembali LUN di luar pemrosesan untuk OnLunEmpty harus terbatas pada keadaan darurat atau administrator yang melakukan tindakan eksplisit secara manual.

Dalam kasus salinan bayangan persisten, pemohon menghapus salinan bayangan ketika tidak lagi diperlukan. Dalam kasus salinan bayangan rilis otomatis yang tidak konsisten, layanan VSS menghapus salinan bayangan saat pemohon memanggil IUnknown::Release pada objek IVssBackupComponents . Dalam kasus salinan bayangan non-rilis otomatis yang tidak konsisten, layanan VSS menghapus salinan bayangan saat komputer dimulai ulang. Dalam semua kasus, layanan VSS memanggil metode OnLunEmpty penyedia sesuai kebutuhan untuk setiap LUN salinan bayangan.

Perhatikan bahwa OnLunEmpty dipanggil berdasarkan upaya terbaik. VSS memanggil metode hanya ketika LUN dijamin kosong. Mungkin ada banyak kasus di mana LUN kosong tetapi VSS tidak dapat mendeteksi ini karena kesalahan atau keadaan eksternal. Dalam hal ini, pengguna harus menggunakan perangkat lunak manajemen penyimpanan untuk menghapus status ini.

Beberapa contoh:

  • Ketika LUN salinan bayangan dipindahkan ke host yang berbeda tetapi tidak benar-benar diangkut atau diimpor melalui VSS, maka LUN tersebut muncul sebagai LUN lainnya, dan volume dapat dihapus begitu saja tanpa pemberitahuan VSS.
  • Crash atau reboot tak terduga di tengah pembuatan salinan bayangan.
  • Impor yang dibatalkan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tidak ada yang didukung
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header vsprov.h

Lihat juga

IVssHardwareSnapshotProvider