estructura CREATE_PARTITION_PARAMETERS (vds.h)

[A partir de Windows 8 y Windows Server 2012, la interfaz COM del servicio de disco virtual se sustituye por la API de administración de almacenamiento de Windows.]

Define los parámetros de partición de un estilo de partición.

Sintaxis

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;

Miembros

style

MbrPartInfo

Parámetros para un disco de registro de arranque maestro (MBR). Se usa si el estilo es VDS_PST_MBR.

MbrPartInfo.partitionType

Indica el tipo de partición MBR definido por el sistema. Los valores posibles son:

Valor Significado
PARTITION_ENTRY_UNUSED
0x00
Entrada sin usar.
PARTITION_FAT_12
0x01
Especifica una partición con entradas FAT de 12 bits.
PARTITION_XENIX_1
0x02
Especifica una partición xenix de tipo 1.
PARTITION_XENIX_2
0x03
Especifica una partición xenix de tipo 2.
PARTITION_FAT_16
0x04
Especifica una partición con entradas FAT de 16 bits.
PARTITION_EXTENDED
0x05
Especifica una partición extendida ms-DOS V4.
PARTITION_HUGE
0x06
Especifica una partición enorme de MS-DOS V4. Este valor indica que no hay ningún sistema de archivos de Microsoft en la partición. Use este valor al crear un volumen lógico.
PARTITION_IFS
0x07
Especifica una partición NTFS o ExFAT.
PARTITION_OS2BOOTMGR
0x0A
Especifica una partición de intercambio coherente, opus o administrador de arranque del sistema operativo/2.
PARTITION_FAT32
0x0B
Especifica una partición FAT32.
PARTITION_FAT32_XINT13
0x0C
Este valor no se admite.
PARTITION_XINT13
0x0E
Este valor no se admite.
PARTITION_XINT13_EXTENDED
0x0F
Este valor no se admite.
PARTITION_PREP
0x41
Especifica una partición de powerPC Reference Platform.
PARTITION_LDM
0x42
Especifica una partición del administrador de discos lógicos.
PARTITION_UNIX
0x63
Especifica una partición UNIX.
PARTITION_NTFT
0x80
Especifica una partición NTFT. Este valor se usa en combinación (es decir, lógicamente ORed bit a bit) con los demás valores de esta tabla.

MbrPartInfo.bootIndicator

Si es TRUE, la partición está activa y se puede arrancar; de lo contrario, no se puede usar la partición para arrancar el sistema.

GptPartInfo

Parámetros para un disco de tabla de particiones GUID (GPT). Se usa si el estilo es VDS_PST_GPT.

GptPartInfo.partitionType

GUID del tipo de partición.

Valor Significado
PARTITION_ENTRY_UNUSED_GUID
00000000-0000-0000-0000-000000000000
No hay ninguna partición.

Este atributo se puede establecer para discos básicos y dinámicos.

PARTITION_SYSTEM_GUID
c12a7328-f81f-11d2-ba4b-00a0c93ec93b
La partición es una partición del sistema EFI.

Este atributo se puede establecer para discos básicos y dinámicos.

PARTITION_MSFT_RESERVED_GUID
e3c9e316-0b5c-4db8-817d-f92df00215ae
La partición es una partición reservada de Microsoft.

Este atributo se puede establecer para discos básicos y dinámicos.

PARTITION_BASIC_DATA_GUID
ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
Tipo de partición de datos creado y reconocido por Windows.

Solo se pueden asignar particiones de este tipo a letras de unidad, recibir rutas guid de volumen, hospedar carpetas montadas (también denominadas puntos de montaje de volumen) y enumerarse mediante llamadas a FindFirstVolume y FindNextVolume.

Este valor solo se puede establecer para discos básicos, con una excepción. Si tanto PARTITION_BASIC_DATA_GUID como GPT_ATTRIBUTE_PLATFORM_REQUIRED se establecen para una partición en un disco básico que posteriormente se convierte en un disco dinámico, la partición sigue siendo una partición básica, aunque el resto del disco sea un disco dinámico. Esto se debe a que la partición se considera una partición OEM en un disco GPT.

PARTITION_LDM_METADATA_GUID
5808c8aa-7e8f-42e0-85d2-e1e90434cfb3
La partición es una partición de metadatos del Administrador de discos lógicos (LDM) en un disco dinámico.

Este valor solo se puede establecer para discos dinámicos.

PARTITION_LDM_DATA_GUID
af9b60a0-1431-4f62-bc68-3311714a69ad
La partición es una partición de datos LDM en un disco dinámico.

Este valor solo se puede establecer para discos dinámicos.

PARTITION_MSFT_RECOVERY_GUID
de94bba4-06d1-4d40-a16a-bfd50179d6ac
La partición es una partición de recuperación de Microsoft.

Este atributo se puede establecer para discos básicos y dinámicos.

GptPartInfo.partitionId

Si es el identificador de la partición. Si se establece en GUID_NULL (0) al crearse, se generará un valor único.

GptPartInfo.attributes

Atributos de la partición. Este puede ser uno o varios de los valores siguientes:

Valor Significado
GPT_ATTRIBUTE_PLATFORM_REQUIRED
0x0000000000000001
Si se establece este atributo, un equipo requiere que la partición funcione correctamente.

Por ejemplo, este atributo debe establecerse para las particiones oem. Tenga en cuenta que si se establece este atributo, puede usar la utilidad DiskPart.exe para realizar operaciones de partición como eliminar la partición. Sin embargo, dado que la partición no es un volumen, no puede usar la utilidad DiskPart.exe para realizar operaciones de volumen en la partición.

Este atributo se puede establecer para discos básicos y dinámicos. Si se establece para una partición en un disco básico y el disco se convierte en un disco dinámico, la partición sigue siendo una partición básica, aunque el resto del disco sea un disco dinámico. Esto se debe a que la partición se considera una partición OEM en un disco GPT.

GPT_BASIC_DATA_ATTRIBUTE_NO_DRIVE_LETTER
0x8000000000000000
Si se establece este atributo, la partición no recibe una letra de unidad de forma predeterminada cuando el disco se mueve a otro equipo o cuando un equipo ve el disco por primera vez.

Este atributo es útil en entornos de red de área de almacenamiento (SAN).

A pesar de su nombre, este atributo se puede establecer para discos básicos y dinámicos.

GPT_BASIC_DATA_ATTRIBUTE_HIDDEN
0x4000000000000000
Si se establece este atributo, el Administrador de montaje no detecta la partición.

Como resultado, la partición no recibe una letra de unidad, no recibe una ruta de acceso GUID de volumen, no hospeda carpetas montadas (también denominadas puntos de montaje de volumen) y no se enumera mediante llamadas a FindFirstVolume y FindNextVolume. Esto garantiza que las aplicaciones como El desfragmentador de disco no tengan acceso a la partición. El Servicio de instantáneas de volumen (VSS) usa este atributo.

A pesar de su nombre, este atributo se puede establecer para discos básicos y dinámicos.

GPT_BASIC_DATA_ATTRIBUTE_SHADOW_COPY
0x2000000000000000
Si se establece este atributo, la partición es una instantánea de otra partición.

El servicio de instantáneas de volumen (VSS) usa este atributo. Este atributo es una indicación del software basado en controladores de filtro del sistema de archivos (como programas antivirus) para evitar la asociación al volumen.

Una aplicación puede usar el atributo para diferenciar un volumen de instantáneas de un volumen de producción. Por ejemplo, una aplicación que realiza una recuperación rápida interrumpirá un LUN de instantánea borrando los atributos de solo lectura y ocultos y este atributo. Este atributo se establece cuando se crea y borra la instantánea cuando se interrumpe la instantánea.

A pesar de su nombre, este atributo se puede establecer para discos básicos y dinámicos.

Windows Server 2003: Este atributo no se admite antes de Windows Server 2003 con SP1.

GPT_BASIC_DATA_ATTRIBUTE_READ_ONLY
0x1000000000000000
Si se establece este atributo, la partición es de solo lectura.

Se producirá un error en todas las solicitudes para escribir en la partición.
IOCTL_DISK_IS_WRITABLE producirá un error con el código de error de ERROR_WRITE_PROTECT Win32, lo que hace que el sistema de archivos se monte como de solo lectura, si hay un sistema de archivos presente.

VSS usa este atributo.

No establezca este atributo para discos dinámicos. Si se establece, se pueden producir errores de E/S y evitar que el sistema de archivos se monte correctamente.

GptPartInfo.name[36]

Cadena Unicode terminada en NULL que especifica el nombre de la partición.

Comentarios

El método IVdsAdvancedDisk::CreatePartition pasa esta estructura como argumento para especificar un conjunto de parámetros.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado vds.h

Consulte también

IVdsAdvancedDisk::CreatePartition

Estructuras de VDS

VDS_PARTITION_STYLE