Metode CreatePartition dari kelas MSFT_Disk

Artikel
03/08/2023

Membuat partisi pada disk.

Sintaks

UInt32 CreatePartition(
  [in]  UInt64  Size,
  [in]  Boolean UseMaximumSize,
  [in]  UInt64  Offset,
  [in]  UInt32  Alignment,
  [in]  Char16  DriveLetter,
  [in]  Boolean AssignDriveLetter,
  [in]  UInt16  MbrType,
  [in]  String  GptType,
  [in]  Boolean IsHidden,
  [in]  Boolean IsActive,
  [out] String  CreatedPartition,
  [out] String  ExtendedStatus
);

Parameter

Ukuran [in]

Ukuran yang diinginkan, dalam byte, untuk partisi. Ini harus sama dengan atau kurang dari ukuran yang ditentukan oleh properti LargestFreeExtent disk. Parameter ini tidak dapat digunakan dengan UseMaximumSize.

UseMaximumSize [in]

Jika TRUE, partisi akan mengisi tingkat bebas terbesar pada disk. Parameter ini tidak dapat digunakan dengan parameter Ukuran .

Offset [in]

Offset partisi, dalam byte. Jika offset tidak diratakan dan parameter Perataan tidak ditentukan, offset dibulatkan ke atas atau ke bawah ke batas perataan terdekat, tergantung pada ukuran disk tempat partisi dibuat.

Perataan [in]

Perataan partisi, dalam byte.

DriveLetter [in]

Huruf kandar yang akan ditetapkan ke partisi pada saat pembuatan. Parameter ini tidak dapat digunakan dengan AssignDriveLetter. Jika kedua parameter ditentukan, kesalahan Parameter Tidak Valid akan dikembalikan. Jika huruf kandar tidak tersedia, partisi akan dibuat, tetapi kesalahan '42002' akan dikembalikan.

AssignDriveLetter [in]

Jika TRUE, huruf kandar berikutnya yang tersedia akan ditetapkan ke partisi yang dibuat. Jika tidak ada lagi huruf kandar yang tersedia, partisi akan dibuat tanpa huruf kandar. Parameter ini tidak dapat digunakan dengan DriveLetter. Jika kedua parameter ditentukan, kesalahan Parameter Tidak Valid akan dikembalikan.

MbrType [in]

Menentukan jenis partisi MBR. Parameter ini hanya dapat diatur jika properti PartitionStyle disk adalah MBR, jika tidak, kesalahan akan dikembalikan. Nilai default parameter ini adalah Huge.

Nilai	Makna
FAT12 1	Partisi sistem file FAT12.
FAT16 4	Partisi sistem file FAT16.
Diperpanjang 5	Partisi yang diperluas.
Besar 6	Partisi besar. Nilai ini menunjukkan bahwa tidak ada sistem file Windows pada partisi. Gunakan nilai ini saat membuat volume logis.
IFS 7	Partisi NTFS atau ExFAT.
FAT32 12	Partisi FAT32.

GptType [in]

Jenis GPT partisi. Parameter ini hanya valid jika properti PartitionStyle disk adalah GPT, jika tidak, kesalahan akan dikembalikan. Nilai default untuk parameter ini adalah data Dasar.

Nilai	Makna
Partisi Sistem c12a7328-f81f-11d2-ba4b-00a0c93ec93b	Partisi sistem EFI.
Microsoft Reserved e3c9e316-0b5c-4db8-817d-f92df00215ae	Partisi cadangan Microsoft.
Data dasar ebd0a0a2-b9e5-4433-87c0-68b6b72699c7	Partisi data dasar. Ini adalah jenis partisi data yang dibuat dan dikenali oleh Windows. Hanya partisi jenis ini yang dapat ditetapkan huruf drive, menerima jalur GUID volume, folder yang dipasang host (juga disebut titik pemasangan volume) dan dijumlahkan oleh panggilan ke FindFirstVolume dan FindNextVolume.
Metadata LDM 5808c8aa-7e8f-42e0-85d2-e1e90434cfb3	Partisi metadata Logical Disk Manager (LDM) pada disk dinamis.
Data LDM af9b60a0-1431-4f62-bc68-3311714a69ad	Partisi adalah partisi data LDM pada disk dinamis.
Microsoft Recovery de94bba4-06d1-4d40-a16a-bfd50179d6ac	Partisi pemulihan Microsoft.

IsHidden [in]

Jika TRUE, partisi tidak akan dapat menerima penetapan huruf drive, manajer pemasangan juga tidak akan menetapkan nama GUID volume. Partisi tidak akan dijumlahkan oleh fungsi FindFirstVolume dan FindNextVolume . Partisi dapat dibuka dengan nama perangkat volume terkait (misalnya, "\\? GLOBALROOT\Device\HarddiskVolumeX").

IsActive [in]

Jika TRUE, bit aktif MBR partisi akan diatur, dan partisi akan menjadi dapat di-boot. Parameter ini hanya valid untuk disk MBR.

CreatedPartition [out]

String yang berisi objek MSFT_Partition yang disematkan yang mewakili partisi yang dibuat.

ExtendedStatus [out]

String yang berisi objek MSFT_StorageExtendedStatus yang disematkan.

Parameter ini memungkinkan penyedia penyimpanan untuk mengembalikan informasi kesalahan yang diperluas (khusus implementasi).

Nilai kembali

Sukses (0)

Tidak Didukung (1)

Kesalahan yang Tidak Ditentukan (2)

Waktu habis (3)

Gagal (4)

Parameter Tidak Valid (5)

Disk sedang digunakan (6)

Ukuran Tidak Didukung (4097)

Tidak cukup ruang kosong (40000)

Akses ditolak (40001)

Tidak ada cukup sumber daya untuk menyelesaikan operasi. (40002)

Cache kedaluarsa (40003)

Anda harus menentukan ukuran dengan menggunakan parameter Ukuran atau UseMaximumSize. Anda hanya dapat menentukan salah satu parameter ini pada satu waktu. (40005)

Disk belum diinisialisasi. (41000)

Disk bersifat baca-saja. (41002)

Disk offline. (41003)

Batas partisi disk telah tercapai. (41004)

Perataan partisi yang ditentukan tidak valid. Ini harus berupa kelipatan ukuran sektor disk. (41005)

Parameter tidak valid untuk jenis partisi ini. (41006)

Tipe partisi yang ditentukan tidak valid. (41010)

Hanya 2 TB pertama yang dapat digunakan pada disk MBR. (41011)

Offset yang ditentukan tidak valid. (41012)

Tidak ada media di perangkat. (41015)

Offset yang ditentukan tidak valid. (41016)

Tata letak partisi yang ditentukan tidak valid. (41017)

Objek yang ditentukan dikelola oleh komponen Pengklusteran Failover Microsoft. Disk harus dalam mode pemeliharaan kluster dan status sumber daya kluster harus online untuk melakukan operasi ini. (41018)

Jalur akses yang diminta sudah digunakan. (42002)

Tidak dapat menetapkan jalur akses ke partisi tersembunyi. (42004)

Jalur akses tidak valid. (42007)

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Ruang nama	Root\Microsoft\Windows\Storage
MOF	Storagewmi.mof

Lihat juga

MSFT_Disk

Bagikan melalui