Metode IVdsPack::AddDisk (vds.h)

  • Artikel

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

Menambahkan disk ke paket online.

Sintaks

HRESULT AddDisk(
  [in] VDS_OBJECT_ID       DiskId,
  [in] VDS_PARTITION_STYLE PartitionStyle,
  [in] BOOL                bAsHotSpare
);

Parameter

[in] DiskId

GUID disk.

[in] PartitionStyle

Gayanya bisa MBR atau GPT. Lihat enumerasi VDS_PARTITION_STYLE .

[in] bAsHotSpare

Jika true, VDS dapat menggunakan disk sebagai cadangan panas; jika tidak, disk tidak dapat digunakan untuk operasi ini. Hanya penyedia perangkat keras yang mendukung hot sparing.

Mengembalikan 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
 Disk berhasil ditambahkan.
VDS_E_NOT_AN_UNALLOCATED_DISK
0x80042418L
 Disk mentah.
VDS_E_OPERATION_DENIED
0x8004240AL
 Disk yang akan ditambahkan sedang dibersihkan.
VDS_E_PROVIDER_FAILURE
0x80042442L
 Ada kegagalan penyedia selama operasi.
VDS_E_NOT_SUPPORTED
0x80042400L
 Menambahkan disk kedua ke paket dasar tidak didukung.
VDS_E_PACK_OFFLINE
0x80042444L
 Paket target tidak dapat diakses.
VDS_E_OBJECT_NOT_FOUND
0x80042405L
 Disk tidak ditemukan.
VDS_E_DMADMIN_METHOD_CALL_FAILED
0x80042420L
 Layanan manajer disk logis (LDM) gagal menyelesaikan metode.
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
 Cache penyedia dinamis rusak.

Keterangan

VDS mengimplementasikan metode ini.

Metode ini menginisialisasi disk mentah (disk yang tidak memiliki partisi yang ditentukan) dan menambahkannya ke paket. Sebelum metode ini dipanggil, disk mentah dimiliki oleh layanan VDS. Setelah metode ini kembali, disk dimiliki oleh penyedia dasar.

Untuk membatalkan efek metode ini—yaitu, untuk menghapus format partisi dan menyebabkan disk menjadi disk mentah yang dimiliki oleh layanan VDS—gunakan metode IVdsAdvancedDisk::Clean .

Anda tidak dapat menggunakan AddDisk untuk menentukan ulang partisi pada disk yang ada.

Jika Anda menambahkan disk GPT ke paket dasar, operasi secara otomatis membuat partisi MSR pada disk. Perangkat yang menjalankan sistem operasi WinPE adalah pengecualian karena administrator mungkin lebih suka membuat partisi ESP pada disk. Partisi ESP, jika ada, harus menjadi partisi pertama pada disk.

Jika Anda menambahkan disk ke paket dinamis, operasi tidak membuat partisi MSR.

Persyaratan

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

Lihat juga

IVdsPack

VDS_PACK_PROP

VDS_PARTITION_STYLE