структура CHANGE_ATTRIBUTES_PARAMETERS (vds.h)

  • Статья

[Начиная с Windows 8 и Windows Server 2012 COM-интерфейс службы виртуальных дисков заменен API управления хранилищем Windows.]

Определяет параметры секции стиля секции.

Синтаксис

typedef struct _CHANGE_ATTRIBUTES_PARAMETERS {
  VDS_PARTITION_STYLE style;
  union {
    struct {
      BOOLEAN bootIndicator;
    } MbrPartInfo;
    struct {
      ULONGLONG attributes;
    } GptPartInfo;
  };
} CHANGE_ATTRIBUTES_PARAMETERS;

Члены

style

Определяет параметры секции. Поддерживаются значения VDS_PST_MBR или VDS_PST_GPT.

MbrPartInfo

Используется, если стильVDS_PST_MBR. Параметры для диска главной загрузочной записи (MBR).

MbrPartInfo.bootIndicator

Если задано значение TRUE, раздел активен и может быть загружен; В противном случае секцию нельзя использовать для загрузки системы.

GptPartInfo

Используется, если стильVDS_PST_GPT. Параметры для диска таблицы разделов GUID (GPT).

GptPartInfo.attributes

Атрибуты секции. Здесь могут содержаться одно или несколько значений из следующего списка:

Значение Значение
GPT_ATTRIBUTE_PLATFORM_REQUIRED
0x0000000000000001
 Если этот атрибут задан, для правильной работы компьютера требуется секция.

Например, этот атрибут должен быть задан для разделов OEM. Обратите внимание, что если этот атрибут задан, можно использовать служебную программу DiskPart.exe для выполнения операций секционирования, таких как удаление секции. Однако, поскольку секция не является томом, нельзя использовать служебную программу DiskPart.exe для выполнения операций тома с секцией.

Этот атрибут можно задать для базовых и динамических дисков. Если он задан для раздела на базовом диске и диск преобразуется в динамический диск, раздел остается базовым, несмотря на то, что остальная часть диска является динамическим диском. Это связано с тем, что секция считается разделом OEM на диске GPT.
GPT_BASIC_DATA_ATTRIBUTE_NO_DRIVE_LETTER
0x8000000000000000
 Если этот атрибут задан, раздел не получает букву диска по умолчанию при перемещении диска на другой компьютер или при первом просмотре диска компьютером.

Этот атрибут полезен в средах SAN.

Несмотря на свое имя, этот атрибут можно задать для базовых и динамических дисков.
GPT_BASIC_DATA_ATTRIBUTE_HIDDEN
0x4000000000000000
 Если этот атрибут задан, раздел не обнаруживается диспетчером подключений.

В результате секция не получает букву диска, не получает путь GUID тома, не размещает подключенные папки (также называемые точками подключения тома) и не перечисляется вызовами FindFirstVolume и FindNextVolume. Это гарантирует, что такие приложения, как дефрагментатор диска, не будут обращаться к разделу. Служба теневого копирования томов (VSS) использует этот атрибут.

Несмотря на свое имя, этот атрибут можно задать для базовых и динамических дисков.
GPT_BASIC_DATA_ATTRIBUTE_SHADOW_COPY
0x2000000000000000
 Если этот атрибут задан, раздел является теневой копией другой секции.

Этот атрибут используется службой теневого копирования томов (VSS). Этот атрибут служит признаком для программного обеспечения на основе драйверов для фильтрации файловой системы (например, антивирусных программ), чтобы избежать присоединения к тому.

Приложение может использовать атрибут , чтобы отличить том теневого копирования от рабочего тома. Например, приложение, выполняющее быстрое восстановление, разрушит теневое копирование LUN путем очистки доступных только для чтения и скрытых атрибутов и этого атрибута. Этот атрибут задается при создании теневой копии и очищается при неисправной теневой копии.

Несмотря на свое имя, этот атрибут можно задать для базовых и динамических дисков.

Windows Server 2003: Этот атрибут не поддерживается до Windows Server 2003 с пакетом обновления 1 (SP1).
GPT_BASIC_DATA_ATTRIBUTE_READ_ONLY
0x1000000000000000
 Если этот атрибут задан, секция доступна только для чтения.

Все запросы на запись в раздел завершатся ошибкой. IOCTL_DISK_IS_WRITABLE завершится сбоем с кодом ошибки Win32 ERROR_WRITE_PROTECT, что приводит к подключению файловой системы только для чтения при наличии файловой системы.

VSS использует этот атрибут.

Не устанавливайте этот атрибут для динамических дисков. Его установка может привести к ошибкам ввода-вывода и предотвратить правильное подключение файловой системы.

Комментарии

Метод IVdsAdvancedDisk::ChangeAttributes принимает эту структуру в качестве параметра.

Требования

   
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть vds.h

См. также раздел

IVdsAdvancedDisk::ChangeAttributes

Структуры VDS