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:
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 |
|---|---|
|
Não há partição.
Esse atributo pode ser definido para discos básicos e dinâmicos. |
|
A partição é uma partição do sistema EFI.
Esse atributo pode ser definido para discos básicos e dinâmicos. |
|
A partição é uma partição reservada da Microsoft.
Esse atributo pode ser definido para discos básicos e dinâmicos. |
|
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. |
|
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. |
|
A partição é uma partição de dados LDM em um disco dinâmico.
Esse valor pode ser definido apenas para discos dinâmicos. |
|
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 |
|---|---|
|
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. |
|
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. |
|
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. |
|
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. |
|
Se esse atributo for definido, a partição será somente leitura.
Todas as solicitações para gravar na partição falharão. 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 |