estrutura CREATE_PARTITION_PARAMETERS (vds.h)

[Começando com Windows 8 e Windows Server 2012, a interface COM do Serviço de Disco Virtual é substituída pela API de Gerenciamento de Armazenamento do Windows.]

Define os parâmetros de partição de um estilo de partição.

Sintaxe

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;

Membros

style

MbrPartInfo

Parâmetros para um disco MBR (Registro mestre de inicialização). Usado se o estilo for VDS_PST_MBR.

MbrPartInfo.partitionType

Indica o tipo de partição MBR definido pelo sistema. Os valores possíveis são:

Valor Significado
PARTITION_ENTRY_UNUSED
0x00
Entrada não utilizado.
PARTITION_FAT_12
0x01
Especifica uma partição com entradas FAT de 12 bits.
PARTITION_XENIX_1
0x02
Especifica uma partição XENIX Tipo 1.
PARTITION_XENIX_2
0x03
Especifica uma partição XENIX Tipo 2.
PARTITION_FAT_16
0x04
Especifica uma partição com entradas FAT de 16 bits.
PARTITION_EXTENDED
0x05
Especifica uma partição estendida MS-DOS V4.
PARTITION_HUGE
0x06
Especifica uma partição enorme MS-DOS V4. Esse valor indica que não há nenhum sistema de arquivos da Microsoft na partição. Use esse valor ao criar um volume lógico.
PARTITION_IFS
0x07
Especifica uma partição NTFS ou ExFAT.
PARTITION_OS2BOOTMGR
0x0A
Especifica um Gerenciador de Inicialização do SO/2, OPUS ou partição de troca coerente.
PARTITION_FAT32
0x0B
Especifica uma partição FAT32.
PARTITION_FAT32_XINT13
0x0C
Não há suporte para esse valor.
PARTITION_XINT13
0x0E
Não há suporte para esse valor.
PARTITION_XINT13_EXTENDED
0x0F
Não há suporte para esse valor.
PARTITION_PREP
0x41
Especifica uma partição da Plataforma de Referência do PowerPC.
PARTITION_LDM
0x42
Especifica uma partição do gerenciador de disco lógico.
PARTITION_UNIX
0x63
Especifica uma partição UNIX.
PARTITION_NTFT
0x80
Especifica uma partição NTFT. Esse valor é usado em combinação (ou seja, logicamente ORed bit a bit) com os outros valores nesta tabela.

MbrPartInfo.bootIndicator

Se TRUE, a partição estará ativa e poderá ser inicializada; caso contrário, a partição não pode ser usada para inicializar o sistema.

GptPartInfo

Parâmetros para um disco gpt (tabela de partição GUID). Usado se o estilo for VDS_PST_GPT.

GptPartInfo.partitionType

Um GUID do tipo de partição.

Valor Significado
PARTITION_ENTRY_UNUSED_GUID
00000000-0000-0000-0000-000000000000
Não há partição.

Esse atributo pode ser definido para discos básicos e dinâmicos.

PARTITION_SYSTEM_GUID
c12a7328-f81f-11d2-ba4b-00a0c93ec93b
A partição é uma partição do sistema EFI.

Esse atributo pode ser definido para discos básicos e dinâmicos.

PARTITION_MSFT_RESERVED_GUID
e3c9e316-0b5c-4db8-817d-f92df00215ae
A partição é uma partição reservada da Microsoft.

Esse atributo pode ser definido para discos básicos e dinâmicos.

PARTITION_BASIC_DATA_GUID
ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
O tipo de partição de dados criado e reconhecido pelo Windows.

Somente partições desse tipo podem ser atribuídas a letras de unidade, receber caminhos GUID de volume, pastas montadas de host (também chamadas de pontos de montagem de volume) e ser enumeradas por chamadas para FindFirstVolume e FindNextVolume.

Esse valor pode ser definido apenas para discos básicos, com uma exceção. Se PARTITION_BASIC_DATA_GUID e GPT_ATTRIBUTE_PLATFORM_REQUIRED estiverem definidos para uma partição em um disco básico posteriormente convertido em um disco dinâmico, a partição permanecerá uma partição básica, mesmo que o restante do disco seja um disco dinâmico. Isso ocorre porque a partição é considerada uma partição OEM em um disco GPT.

PARTITION_LDM_METADATA_GUID
5808c8aa-7e8f-42e0-85d2-e1e90434cfb3
A partição é uma partição de metadados do LDM (Logical Disk Manager) em um disco dinâmico.

Esse valor só pode ser definido para discos dinâmicos.

PARTITION_LDM_DATA_GUID
af9b60a0-1431-4f62-bc68-3311714a69ad
A partição é uma partição de dados LDM em um disco dinâmico.

Esse valor pode ser definido apenas para discos dinâmicos.

PARTITION_MSFT_RECOVERY_GUID
de94bba4-06d1-4d40-a16a-bfd50179d6ac
A partição é uma partição de recuperação da Microsoft.

Esse atributo pode ser definido para discos básicos e dinâmicos.

GptPartInfo.partitionId

Se a ID da partição. Se definido como GUID_NULL (0) na criação, um valor exclusivo será gerado.

GptPartInfo.attributes

Atributos da partição. Esse valor pode ser um ou mais dos seguintes:

Valor Significado
GPT_ATTRIBUTE_PLATFORM_REQUIRED
0x0000000000000001
Se esse atributo for definido, a partição será exigida por um computador para funcionar corretamente.

Por exemplo, esse atributo deve ser definido para partições OEM. Observe que, se esse atributo estiver definido, você poderá usar o utilitário DiskPart.exe para executar operações de partição, como excluir a partição. No entanto, como a partição não é um volume, você não pode usar o utilitário DiskPart.exe para executar operações de volume na partição.

Esse atributo pode ser definido para discos básicos e dinâmicos. Se ele for definido para uma partição em um disco básico e o disco for convertido em um disco dinâmico, a partição permanecerá uma partição básica, mesmo que o restante do disco seja um disco dinâmico. Isso ocorre porque a partição é considerada uma partição OEM em um disco GPT.

GPT_BASIC_DATA_ATTRIBUTE_NO_DRIVE_LETTER
0x8000000000000000
Se esse atributo for definido, a partição não receberá uma letra da unidade por padrão quando o disco for movido para outro computador ou quando o disco for visto pela primeira vez por um computador.

Esse atributo é útil em SAN (ambientes de rede de área de armazenamento).

Apesar do nome, esse atributo pode ser definido para discos básicos e dinâmicos.

GPT_BASIC_DATA_ATTRIBUTE_HIDDEN
0x4000000000000000
Se esse atributo for definido, a partição não será detectada pelo Gerenciador de Montagem.

Como resultado, a partição não recebe uma letra da unidade, não recebe um caminho GUID de volume, não hospeda pastas montadas (também chamadas de pontos de montagem de volume) e não é enumerada por chamadas para FindFirstVolume e FindNextVolume. Isso garante que aplicativos como o Desfragmentador de Disco não acessem a partição. O VSS (Serviço de Cópias de Sombra de Volume) usa esse atributo.

Apesar do nome, esse atributo pode ser definido para discos básicos e dinâmicos.

GPT_BASIC_DATA_ATTRIBUTE_SHADOW_COPY
0x2000000000000000
Se esse atributo for definido, a partição será uma cópia de sombra de outra partição.

Esse atributo é usado pelo VSS (Serviço de Cópia de Sombra de Volume). Esse atributo é uma indicação para o software baseado em driver de filtro do sistema de arquivos (como programas antivírus) para evitar a anexação ao volume.

Um aplicativo pode usar o atributo para diferenciar um volume de cópia de sombra de um volume de produção. Por exemplo, um aplicativo que executa uma recuperação rápida interromperá um LUN de cópia de sombra limpando os atributos somente leitura e ocultos e esse atributo. Esse atributo é definido quando a cópia de sombra é criada e desmarcada quando a cópia de sombra é interrompida.

Apesar do nome, esse atributo pode ser definido para discos básicos e dinâmicos.

Windows Server 2003: Não há suporte para esse atributo antes do Windows Server 2003 com SP1.

GPT_BASIC_DATA_ATTRIBUTE_READ_ONLY
0x1000000000000000
Se esse atributo for definido, a partição será somente leitura.

Todas as solicitações para gravar na partição falharão.
IOCTL_DISK_IS_WRITABLE falhará com o código de erro ERROR_WRITE_PROTECT Win32, o que fará com que o sistema de arquivos seja montado como somente leitura, se um sistema de arquivos estiver presente.

O VSS usa esse atributo.

Não defina esse atributo para discos dinâmicos. Defini-lo pode causar erros de E/S e impedir que o sistema de arquivos seja montado corretamente.

GptPartInfo.name[36]

Cadeia de caracteres Unicode terminada em nulo que especifica o nome da partição.

Comentários

O método IVdsAdvancedDisk::CreatePartition passa essa estrutura como um argumento para especificar um conjunto de parâmetros.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho vds.h

Confira também

IVdsAdvancedDisk::CreatePartition

Estruturas VDS

VDS_PARTITION_STYLE