IVdsPack::ReplaceDisk method (vds.h)

Artikel
03/09/2024

[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh WINDOWS Storage Management API.]

Tidak didukung.

Metode ini disediakan untuk digunakan di masa mendatang.

Sintaks

HRESULT ReplaceDisk(
  [in]  VDS_OBJECT_ID OldDiskId,
  [in]  VDS_OBJECT_ID NewDiskId,
  [out] IVdsAsync     **ppAsync
);

Parameter

[in] OldDiskId

GUID disk lama.

[in] NewDiskId

GUID disk baru.

[out] ppAsync

Alamat penunjuk antarmuka IVdsAsync , yang diinisialisasi VDS saat dikembalikan. Penelepon harus merilis antarmuka. Gunakan antarmuka ini untuk membatalkan, menunggu, atau mengkueri status operasi.

Menampilkan nilai

Metode ini dapat mengembalikan nilai HRESULT standar, seperti E_INVALIDARG atau E_OUTOFMEMORY, dan nilai pengembalian khusus VDS. Ini juga dapat mengembalikan kode kesalahan sistem yang dikonversi menggunakan makro HRESULT_FROM_WIN32 . Kesalahan dapat berasal dari VDS itu sendiri atau dari penyedia VDS yang mendasar yang sedang digunakan. Kemungkinan nilai yang dikembalikan termasuk yang berikut ini.

Mengembalikan kode/nilai	Deskripsi
S_OK	Penggantian disk berhasil diselesaikan.
VDS_E_NOT_SUPPORTED 0x80042400L	Metode ini tidak didukung dalam rilis ini.

Keterangan

Pemanggil dapat menggunakan metode ini untuk migrasi media (mengganti disk lama dengan disk baru) atau saat memperbaiki set toleran terhadap kesalahan dengan anggota yang hilang atau gagal—terutama untuk penyedia yang tidak menerapkan hemat panas.

Disk baru harus berada dalam paket yang sama dengan disk lama dan tidak boleh berisi data; itu dapat memiliki gaya partisi yang salah. Jika terjadi penggantian yang berhasil, disk lama mempertahankan gaya partisi tetapi tidak ada volume yang valid.

Pelaksana harus mengembalikan pointer ke antarmuka IVdsAsync untuk metode ini, terlepas dari apakah panggilan memulai operasi asinkron. Jika penyedia Anda tidak menerapkan hot sparing, penyedia harus mendukung skenario failed-member: mulai menyinkronkan volume toleran terhadap kesalahan yang terekspos lagi setelah penelepon memanggil metode ReplaceDisk .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	vds.h
Pustaka	Uuid.lib

Bagikan melalui