Metode IVssHardwareSnapshotProvider::BeginPrepareSnapshot (vsprov.h)

  • Artikel

Metode BeginPrepareSnapshot dipanggil untuk setiap salinan bayangan yang ditambahkan ke set salinan bayangan.

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

Sintaks

HRESULT BeginPrepareSnapshot(
  [in]      VSS_ID              SnapshotSetId,
  [in]      VSS_ID              SnapshotId,
  [in]      LONG                lContext,
  [in]      LONG                lLunCount,
  [in]      VSS_PWSZ            *rgDeviceNames,
  [in, out] VDS_LUN_INFORMATION *rgLunInformation
);

Parameter

[in] SnapshotSetId

Pengidentifikasi set salinan bayangan.

[in] SnapshotId

Pengidentifikasi salinan bayangan yang akan dibuat.

[in] lContext

Konteks salinan bayangan untuk kumpulan salinan bayangan saat ini sebagaimana dijumlahkan oleh _VSS_VOLUME_SNAPSHOT_ATTRIBUTES.

[in] lLunCount

Jumlah LUN yang berkontribusi pada volume salinan bayangan ini.

[in] rgDeviceNames

Penunjuk ke array penunjuk lLunCount ke string, setiap string yang berisi nama LUN yang akan disalin bayangan.

[in, out] rgLunInformation

Penunjuk ke array struktur lLunCountVDS_LUN_INFORMATION , satu untuk setiap LUN yang berkontribusi pada volume salinan bayangan ini.

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_MAXIMUM_NUMBER_OF_VOLUMES_REACHED
0x80042312L
 Penyedia telah mencapai jumlah maksimum volume yang dapat didukungnya.
VSS_E_NESTED_VOLUME_LIMIT
 Volume yang ditentukan ditumpuk terlalu dalam untuk berpartisipasi dalam operasi VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Kode pengembalian ini tidak didukung.
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.
VSS_E_VOLUME_NOT_SUPPORTED_BY_PROVIDER
0x8004230EL
 Penyedia tidak mendukung volume ini.
VSS_E_UNSUPPORTED_CONTEXT
0x8004231BL
 Konteks yang ditentukan oleh lContext tidak didukung.

Keterangan

Metode ini tidak dapat dipanggil untuk hard disk virtual (VHD) yang bersarang di dalam VHD lain.

Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: VHD tidak didukung.

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

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES