Metode IVssHardwareSnapshotProvider::LocateLuns (vsprov.h)

  • Artikel

Metode LocateLuns meminta penyedia perangkat keras untuk membuat LUN salinan bayangan terlihat oleh komputer. Metode LocateLuns dipanggil oleh VSS ketika kumpulan salinan bayangan perangkat keras diimpor ke komputer. Penyedia bertanggung jawab atas pembukaan kedok (atau "memunculkan") di tingkat perangkat keras.

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

Sintaks

HRESULT LocateLuns(
  [in] LONG                lLunCount,
  [in] VDS_LUN_INFORMATION *rgSourceLuns
);

Parameter

[in] lLunCount

Jumlah LUN yang berkontribusi pada set salinan bayangan ini.

[in] rgSourceLuns

Penunjuk ke array struktur VDS_LUN_INFORMATION iLunCount, satu untuk setiap LUN yang merupakan bagian dari set salinan bayangan yang akan diimpor.

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

Dalam parameter rgSourceLuns , VSS menyediakan array struktur VDS_LUN_INFORMATION yang sama dengan yang sebelumnya diinisialisasi penyedia dalam metode IVssHardwareSnapshotProvider::GetTargetLuns . Untuk setiap struktur VDS_LUN_INFORMATION dalam array, penyedia harus membuka kemasan (atau "permukaan") LUN salinan bayangan yang sesuai ke komputer.

Segera setelah metode ini kembali, VSS akan melakukan pemulaian ulang dan enumerasi untuk mendeteksi perangkat yang tiba. Ini menyebabkan LUN yang terekspos ditemukan oleh manajer PnP. Secara paralel dengan mendengarkan kedatangan disk, VSS juga akan mendengarkan kedatangan volume tersembunyi. VSS akan berhenti mendengarkan setelah semua volume yang berkontribusi pada set salinan bayangan muncul di sistem atau waktu habis terjadi. Jika beberapa disk atau perangkat volume gagal muncul di jendela ini, pemohon akan diberi tahu bahwa hanya beberapa salinan bayangan yang diimpor oleh VSS yang mengembalikan VSS_S_SOME_SNAPSHOTS_NOT_IMPORTED ke pemohon. Pemohon juga akan menerima kesalahan yang sama dari VSS jika struktur VDS_LUN_INFORMATION yang diterima dari metode GetTargetLuns dan IVssHardwareSnapshotProvider::FillInLunInfo tidak cocok.

Metode ini tidak dapat digunakan untuk memetakan LUN salinan bayangan sebagai baca-saja.

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

AreLunsSupported

FillInLunInfo

GetTargetLuns

IVssHardwareSnapshotProvider

VDS_LUN_INFORMATION