Share via

struktur CREATE_PARTITION_PARAMETERS (vds.h)

  • Artikel

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

Menentukan parameter partisi dari gaya partisi.

Sintaks

typedef struct _CREATE_PARTITION_PARAMETERS {
  VDS_PARTITION_STYLE style;
  union {
    struct {
      BYTE    partitionType;
      BOOLEAN bootIndicator;
    } MbrPartInfo;
    struct {
      GUID      partitionType;
      GUID      partitionId;
      ULONGLONG attributes;
      WCHAR     name[36];
    } GptPartInfo;
  };
} CREATE_PARTITION_PARAMETERS;

Anggota

style

MbrPartInfo

Parameter untuk disk Master Boot Record (MBR). Digunakan jika gayaVDS_PST_MBR.

MbrPartInfo.partitionType

Menunjukkan jenis partisi MBR yang ditentukan sistem. Kemungkinan nilainya adalah sebagai berikut:

Nilai Makna
PARTITION_ENTRY_UNUSED
0x00
 Entri yang tidak digunakan.
PARTITION_FAT_12
0x01
 Menentukan partisi dengan entri FAT 12-bit.
PARTITION_XENIX_1
0x02
 Menentukan partisi XENIX Tipe 1.
PARTITION_XENIX_2
0x03
 Menentukan partisi XENIX Tipe 2.
PARTITION_FAT_16
0x04
 Menentukan partisi dengan entri FAT 16-bit.
PARTITION_EXTENDED
0x05
 Menentukan partisi yang diperluas MS-DOS V4.
PARTITION_HUGE
0x06
 Menentukan partisi besar MS-DOS V4. Nilai ini menunjukkan bahwa tidak ada sistem file Microsoft pada partisi. Gunakan nilai ini saat membuat volume logis.
PARTITION_IFS
0x07
 Menentukan partisi NTFS atau ExFAT.
PARTITION_OS2BOOTMGR
0x0A
 Menentukan partisi Boot Manager OS/2, OPUS, atau Coherent swap.
PARTITION_FAT32
0x0B
 Menentukan partisi FAT32.
PARTITION_FAT32_XINT13
0x0C
 Nilai ini tidak didukung.
PARTITION_XINT13
0x0E
 Nilai ini tidak didukung.
PARTITION_XINT13_EXTENDED
0x0F
 Nilai ini tidak didukung.
PARTITION_PREP
0x41
 Menentukan partisi Platform Referensi PowerPC.
PARTITION_LDM
0x42
 Menentukan partisi manajer disk logis.
PARTITION_UNIX
0x63
 Menentukan partisi UNIX.
PARTITION_NTFT
0x80
 Menentukan partisi NTFT. Nilai ini digunakan dalam kombinasi (yaitu, bitwise logis ORed) dengan nilai lain dalam tabel ini.

MbrPartInfo.bootIndicator

Jika TRUE, partisi aktif dan dapat di-boot; jika tidak, partisi tidak dapat digunakan untuk mem-boot sistem.

GptPartInfo

Parameter untuk disk Tabel Partisi GUID (GPT). Digunakan jika gayaVDS_PST_GPT.

GptPartInfo.partitionType

GUID dari jenis partisi.

Nilai Makna
PARTITION_ENTRY_UNUSED_GUID
00000000-0000-0000-0000-000000000000
 Tidak ada partisi.

Atribut ini dapat diatur untuk disk dasar dan dinamis.
PARTITION_SYSTEM_GUID
c12a7328-f81f-11d2-ba4b-00a0c93ec93b
 Partisi adalah partisi sistem EFI.

Atribut ini dapat diatur untuk disk dasar dan dinamis.
PARTITION_MSFT_RESERVED_GUID
e3c9e316-0b5c-4db8-817d-f92df00215ae
 Partisi adalah partisi cadangan Microsoft.

Atribut ini dapat diatur untuk disk dasar dan dinamis.
PARTITION_BASIC_DATA_GUID
ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
 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.

Nilai ini hanya dapat diatur untuk disk dasar, dengan satu pengecualian. Jika PARTITION_BASIC_DATA_GUID dan GPT_ATTRIBUTE_PLATFORM_REQUIRED diatur untuk partisi pada disk dasar yang kemudian dikonversi ke disk dinamis, partisi tetap menjadi partisi dasar, meskipun sisa disk adalah disk dinamis. Ini karena partisi dianggap sebagai partisi OEM pada disk GPT.
PARTITION_LDM_METADATA_GUID
5808c8aa-7e8f-42e0-85d2-e1e90434cfb3
 Partisi adalah partisi metadata Logical Disk Manager (LDM) pada disk dinamis.

Nilai ini hanya dapat diatur untuk disk dinamis.
PARTITION_LDM_DATA_GUID
af9b60a0-1431-4f62-bc68-3311714a69ad
 Partisi adalah partisi data LDM pada disk dinamis.

Nilai ini hanya dapat diatur untuk disk dinamis.
PARTITION_MSFT_RECOVERY_GUID
de94bba4-06d1-4d40-a16a-bfd50179d6ac
 Partisi adalah partisi pemulihan Microsoft.

Atribut ini dapat diatur untuk disk dasar dan dinamis.

GptPartInfo.partitionId

Jika ID partisi. Jika diatur ke GUID_NULL (0) saat pembuatan, nilai unik akan dihasilkan.

GptPartInfo.attributes

Atribut partisi. Ini bisa berupa satu atau beberapa nilai berikut ini:

Nilai Makna
GPT_ATTRIBUTE_PLATFORM_REQUIRED
0x0000000000000001
 Jika atribut ini diatur, partisi diperlukan oleh komputer untuk berfungsi dengan baik.

Misalnya, atribut ini harus diatur untuk partisi OEM. Perhatikan bahwa jika atribut ini diatur, Anda dapat menggunakan utilitas DiskPart.exe untuk melakukan operasi partisi seperti menghapus partisi. Namun, karena partisi bukan volume, Anda tidak dapat menggunakan utilitas DiskPart.exe untuk melakukan operasi volume pada partisi.

Atribut ini dapat diatur untuk disk dasar dan dinamis. Jika diatur untuk partisi pada disk dasar dan disk dikonversi ke disk dinamis, partisi tetap menjadi partisi dasar, meskipun sisa disk adalah disk dinamis. Ini karena partisi dianggap sebagai partisi OEM pada disk GPT.
GPT_BASIC_DATA_ATTRIBUTE_NO_DRIVE_LETTER
0x8000000000000000
 Jika atribut ini diatur, partisi tidak menerima huruf kandar secara default ketika disk dipindahkan ke komputer lain atau ketika disk terlihat untuk pertama kalinya oleh komputer.

Atribut ini berguna di lingkungan jaringan area penyimpanan (SAN).

Terlepas dari namanya, atribut ini dapat diatur untuk disk dasar dan dinamis.
GPT_BASIC_DATA_ATTRIBUTE_HIDDEN
0x4000000000000000
 Jika atribut ini diatur, partisi tidak terdeteksi oleh Mount Manager.

Akibatnya, partisi tidak menerima huruf kandar, tidak menerima jalur GUID volume, tidak menghosting folder yang dipasang (juga disebut titik pemasangan volume), dan tidak dijumlahkan oleh panggilan ke FindFirstVolume dan FindNextVolume. Ini memastikan bahwa aplikasi seperti Defragmenter Disk tidak mengakses partisi. Layanan Menyalin Bayangan Volume (VSS) menggunakan atribut ini.

Terlepas dari namanya, atribut ini dapat diatur untuk disk dasar dan dinamis.
GPT_BASIC_DATA_ATTRIBUTE_SHADOW_COPY
0x2000000000000000
 Jika atribut ini diatur, partisi adalah salinan bayangan dari partisi lain.

Atribut ini digunakan oleh layanan Volume Shadow Copy (VSS). Atribut ini adalah indikasi untuk perangkat lunak berbasis driver filter sistem file (seperti program antivirus) untuk menghindari melampirkan ke volume.

Aplikasi dapat menggunakan atribut untuk membedakan volume salinan bayangan dari volume produksi. Misalnya, aplikasi yang melakukan pemulihan cepat akan merusak LUN salinan bayangan dengan menghapus atribut baca-saja dan tersembunyi dan atribut ini. Atribut ini diatur ketika salinan bayangan dibuat dan dibersihkan saat salinan bayangan rusak.

Terlepas dari namanya, atribut ini dapat diatur untuk disk dasar dan dinamis.

Windows Server 2003: Atribut ini tidak didukung sebelum Windows Server 2003 dengan SP1.
GPT_BASIC_DATA_ATTRIBUTE_READ_ONLY
0x1000000000000000
 Jika atribut ini diatur, partisi bersifat baca-saja.

Semua permintaan untuk menulis ke partisi akan gagal.
IOCTL_DISK_IS_WRITABLE akan gagal dengan kode kesalahan ERROR_WRITE_PROTECT Win32, yang menyebabkan sistem file dipasang sebagai baca-saja, jika ada sistem file.

VSS menggunakan atribut ini.

Jangan atur atribut ini untuk disk dinamis. Mengaturnya dapat menyebabkan kesalahan I/O dan mencegah sistem file dipasang dengan benar.

GptPartInfo.name[36]

Untai (karakter) Unicode yang dihentikan null yang menentukan nama partisi.

Keterangan

Metode IVdsAdvancedDisk::CreatePartition melewati struktur ini sebagai argumen untuk menentukan sekumpulan parameter.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Header vds.h

Lihat juga

IVdsAdvancedDisk::CreatePartition

Struktur VDS

VDS_PARTITION_STYLE