Metode IVdsCreatePartitionEx::CreatePartitionEx (vds.h)

  • Artikel

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

Membuat partisi pada disk dasar.

Metode ini menggantikan metode IVdsAdvancedDisk::CreatePartition .

Sintaks

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

Parameter

[in] ullOffset

Offset partisi, dalam byte. Jika offset tidak diratakan dan parameter ulAlign tidak ditentukan, offset dibulatkan ke atas atau ke bawah ke batas perataan terdekat tergantung pada ukuran disk tempat partisi dibuat. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

Windows Server 2003: Hanya partisi pertama pada disk dasar yang dapat diselaraskan; disk dinamis tidak dapat diselaraskan. Untuk partisi lain pada disk dasar, Anda tidak dapat menentukan perataan menggunakan parameter ulAlign ; offset dibulatkan ke batas silinder terdekat untuk disk Master Boot Record (MBR), atau batas sektor terdekat untuk disk GUID Partition Table (GPT).

Ketika pemanggil menentukan parameter ullOffset dan ulAlign , offset harus berada dalam silinder pertama.

[in] ullSize

Ukuran, dalam byte, dari partisi baru.

[in] ulAlign

Ukuran perataan, dalam byte.

Windows Server 2003: Jika parameter ini ditentukan, penyedia membulatkan offset partisi ke batas perataan terdekat; jika tidak, ke batas silinder terdekat.

Jika awal disk memiliki ruang yang cukup untuk mengakomodasi ukuran partisi, dan parameter ulAlign ditentukan tetapi parameter ullOffset tidak, panggilan ke CreatePartitionEx gagal.

[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.

Nilai kembali

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
 Partisi berhasil dibuat.
VDS_E_NO_MEDIA
0x80042412L
 Tidak ada media dalam kandar yang bisa dilepas.
VDS_E_DISK_IS_READ_ONLY
0x8004280BL
 Partisi tidak dapat dibuat, karena disk bersifat baca-saja.
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 (partisi utama atau partisi utama dengan partisi yang diperluas) sudah ada ketika pemanggil mencoba membuat partisi primer 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.

Keterangan

Metode ini beroperasi pada disk dasar yang memiliki skema partisi GPT atau MBR.

Windows Server 2003: Penelepon hanya dapat menyelaraskan partisi pertama disk MBR dan harus menempatkan offset awal di silinder pertama atau awal silinder kedua, pada batas silinder.

Jika parameter ullOffset ditentukan dan nilainya belum diselaraskan menggunakan nilai di bawahsubkunci registri Vds\Alignment Vds AlignmentSystem\HKEY_LOCAL_MACHINE,\\ nilainya akan diselaraskan\ secara otomatis menggunakan nilai berikut: Perataan default adalah 1 MB jika disk 4 GB atau lebih besar, atau 64 KB jika disk lebih kecil dari 4 GB.

Windows Server 2003: Offset partisi yang tidak ditandatangani dibulatkan ke batas silinder terdekat untuk disk MBR, atau ke batas sektor terdekat untuk disk GPT.

Jika disk dinamis bersifat baca-saja dan offline, disk harus dibuat baca/tulis dan dibawa online sebagai berikut sebelum memanggil CreatePartitionEx:

  1. Bersihkan bit baca-saja. (Ini adalah bendera VDS_DF_READ_ONLY dalam struktur VDS_DISK_PROP .)
  2. Panggil metode IVdsDiskOnline::Online .

Persyaratan

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

Lihat juga

IVdsAdvancedDisk::CreatePartition

IVdsAsync

IVdsCreatePartitionEx