Metode IVdsAdvancedDisk::CreatePartition (vds.h)

[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh API Manajemen Penyimpanan Windows.]

Membuat partisi pada disk dasar.

Metode IVdsCreatePartitionEx::CreatePartitionEx menggantikan metode ini.

Sintaks

HRESULT CreatePartition(
  [in]  ULONGLONG                   ullOffset,
  [in]  ULONGLONG                   ullSize,
  [in]  CREATE_PARTITION_PARAMETERS *para,
  [out] IVdsAsync                   **ppAsync
);

Parameter

[in] ullOffset

Offset partisi.

[in] ullSize

Ukuran, dalam byte, dari partisi baru.

[in] para

Penunjuk ke parameter yang ditentukan oleh struktur CREATE_PARTITION_PARAMETERS .

[out] ppAsync

Alamat penunjuk antarmuka IVdsAsync , yang diinisialisasi VDS saat dikembalikan. Penelepon harus merilis antarmuka. Gunakan penunjuk 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. Nilai yang mungkin dikembalikan termasuk yang berikut ini.

Mengembalikan kode/nilai Deskripsi
S_OK
Partisi berhasil dibuat.
VDS_E_NO_MEDIA
0x80042412L
Tidak ada media dalam kandar yang bisa dilepas.
VDS_E_INVALID_OPERATION
0x80042415L
Media tidak mendukung operasi ini. Misalnya, pemanggil tidak dapat membuat partisi pada CD-ROM.
VDS_E_NOT_SUPPORTED
0x80042400L
Membuat partisi kedua pada media yang dapat dilepas tidak didukung. Atau, kesalahan ini menunjukkan disk adalah disk dinamis.
VDS_E_PARTITION_LIMIT_REACHED
0x80042407L
Jumlah maksimum partisi (empat primer, atau tiga primer dan satu diperpanjang) sudah ada ketika pemanggil mencoba membuat partisi utama tambahan atau partisi yang diperluas.
VDS_S_UPDATE_BOOTFILE_FAILED
0x00042434L
Partisi berhasil dibuat, tetapi VDS gagal memperbarui opsi boot di penyimpanan Boot Configuration Data (BCD).

Windows Server 2003: Opsi boot disimpan dalam file boot.ini pada sistem x86 atau x64 atau NVRAM pada sistem Itanium.

Persyaratan

   
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

CREATE_PARTITION_PARAMETERS

Objek Disk

IVdsAdvancedDisk

IVdsAsync

IVdsCreatePartitionEx::CreatePartitionEx