struktur CHANGE_ATTRIBUTES_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 _CHANGE_ATTRIBUTES_PARAMETERS {
  VDS_PARTITION_STYLE style;
  union {
    struct {
      BOOLEAN bootIndicator;
    } MbrPartInfo;
    struct {
      ULONGLONG attributes;
    } GptPartInfo;
  };
} CHANGE_ATTRIBUTES_PARAMETERS;

Anggota

style

Menentukan parameter partisi. Nilai yang didukung VDS_PST_MBR atau VDS_PST_GPT.

MbrPartInfo

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

MbrPartInfo.bootIndicator

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

GptPartInfo

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

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 disk lainnya 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 disk terlihat untuk pertama kalinya oleh komputer.

Atribut ini berguna di lingkungan 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 Disk Defragmenter 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. Aplikasi yang melakukan pemulihan cepat, misalnya, akan merusak LUN salinan bayangan dengan menghapus atribut baca-saja dan tersembunyi dan atribut ini. Atribut ini diatur ketika salinan bayangan dibuat dan dibersihkan ketika 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.

Keterangan

Metode IVdsAdvancedDisk::ChangeAttributes mengambil struktur ini sebagai parameter.

Persyaratan

   
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::ChangeAttributes

Struktur VDS