Método CreatePartition da classe MSFT_Disk

Cria uma partição em um disco.

Sintaxe

UInt32 CreatePartition(
  [in]  UInt64  Size,
  [in]  Boolean UseMaximumSize,
  [in]  UInt64  Offset,
  [in]  UInt32  Alignment,
  [in]  Char16  DriveLetter,
  [in]  Boolean AssignDriveLetter,
  [in]  UInt16  MbrType,
  [in]  String  GptType,
  [in]  Boolean IsHidden,
  [in]  Boolean IsActive,
  [out] String  CreatedPartition,
  [out] String  ExtendedStatus
);

Parâmetros

Tamanho [in]

O tamanho desejado, em bytes, para a partição. Isso deve ser igual ou menor que o tamanho especificado pela propriedade FreeExtent do disco. Esse parâmetro não pode ser usado com UseMaximumSize.

UseMaximumSize [in]

Se TRUE, a partição preencherá a maior extensão livre no disco. Esse parâmetro não pode ser usado com o parâmetro Size .

Deslocamento [in]

O deslocamento de partição, em bytes. Se o deslocamento não estiver alinhado e o parâmetro Alignment não for especificado, o deslocamento será arredondado para cima ou para baixo até o limite de alinhamento mais próximo, dependendo do tamanho do disco no qual a partição é criada.

Alinhamento [in]

O alinhamento da partição, em bytes.

DriveLetter [in]

A letra da unidade a ser atribuída à partição no momento da criação. Esse parâmetro não pode ser usado com AssignDriveLetter. Se ambos os parâmetros forem especificados, um erro de parâmetro inválido será retornado. Se a letra da unidade não estiver disponível, a partição será criada, mas o erro '42002' será retornado.

AssignDriveLetter [in]

Se TRUE, a próxima letra da unidade disponível será atribuída à partição criada. Se não houver mais letras de unidade disponíveis, a partição será criada sem letra da unidade. Esse parâmetro não pode ser usado com DriveLetter. Se ambos os parâmetros forem especificados, um erro de parâmetro inválido será retornado.

MbrType [in]

Especifica o tipo de partição MBR. Esse parâmetro só poderá ser definido se a propriedade PartitionStyle do disco for MBR, caso contrário, um erro será retornado. O valor padrão desse parâmetro é Huge.

Valor	Significado
FAT12 1	Uma partição do sistema de arquivos FAT12.
FAT16 4	Uma partição do sistema de arquivos FAT16.
Estendido 5	Uma partição estendida.
Enorme 6	Uma partição enorme. Esse valor indica que não há nenhum sistema de arquivos do Windows na partição. Use esse valor ao criar um volume lógico.
IFS 7	Uma partição NTFS ou ExFAT.
FAT32 12	Uma partição FAT32.

GptType [in]

O tipo GPT da partição. Esse parâmetro só será válido se a propriedade PartitionStyle do disco for GPT, caso contrário, um erro será retornado. O valor padrão para esse parâmetro é Dados básicos.

Valor	Significado
Partição do Sistema c12a7328-f81f-11d2-ba4b-00a0c93ec93b	Uma partição do sistema EFI.
Microsoft Reserved e3c9e316-0b5c-4db8-817d-f92df00215ae	Uma partição reservada da Microsoft.
Dados básicos ebd0a0a2-b9e5-4433-87c0-68b6b72699c7	Uma partição de dados básica. Esse é o tipo de partição de dados criado e reconhecido pelo Windows. Somente partições desse tipo podem ser atribuídas letras de unidade, receber caminhos GUID de volume, pastas montadas do host (também chamadas de pontos de montagem de volume) e ser enumeradas por chamadas para FindFirstVolume e FindNextVolume.
Metadados LDM 5808c8aa-7e8f-42e0-85d2-e1e90434cfb3	Uma partição de metadados do LDM (Gerenciador de Disco Lógico) em um disco dinâmico.
Dados LDM af9b60a0-1431-4f62-bc68-3311714a69ad	A partição é uma partição de dados LDM em um disco dinâmico.
Microsoft Recovery de94bba4-06d1-4d40-a16a-bfd50179d6ac	Uma partição de recuperação da Microsoft.

IsHidden [in]

Se TRUE, a partição não poderá receber uma atribuição de letra de unidade, nem o gerenciador de montagem atribuirá um nome GUID de volume. A partição não será enumerada pelas funções FindFirstVolume e FindNextVolume . A partição pode ser aberta pelo nome do dispositivo de volume associado (por exemplo, "\\? GLOBALROOT\Device\HarddiskVolumeX").

IsActive [in]

Se TRUE, o bit ativo MBR da partição será definido e a partição se tornará inicializável. Esse parâmetro só é válido para discos MBR.

CreatedPartition [out]

Uma cadeia de caracteres que contém um objeto MSFT_Partition inserido que representa a partição que foi criada.

ExtendedStatus [out]

Uma cadeia de caracteres que contém um objeto MSFT_StorageExtendedStatus inserido.

Esse parâmetro permite que o provedor de armazenamento retorne informações de erro estendidas (específicas da implementação).

Retornar valor

Êxito (0)

Sem suporte (1)

Erro não especificado (2)

Tempo limite (3)

Falha (4)

Parâmetro inválido (5)

O disco está em uso (6)

Tamanho sem suporte (4097)

Não há espaço livre suficiente (40000)

Acesso negado (40001)

Não há recursos suficientes para concluir a operação. (40002)

Cache desatualizado (40003)

Você deve especificar um tamanho usando o parâmetro Size ou UseMaximumSize. Você pode especificar apenas um desses parâmetros por vez. (40005)

O disco não foi inicializado. (41000)

O disco é somente leitura. (41002)

O disco está offline. (41003)

O limite de partição do disco foi atingido. (41004)

O alinhamento de partição especificado não é válido. Deve ser um múltiplo do tamanho do setor do disco. (41005)

Um parâmetro não é válido para esse tipo de partição. (41006)

O tipo de partição especificado não é válido. (41010)

Somente os primeiros 2 TB são utilizáveis em discos MBR. (41011)

O deslocamento especificado não é válido. (41012)

Não há mídia no dispositivo. (41015)

O deslocamento especificado não é válido. (41016)

O layout de partição especificado é inválido. (41017)

O objeto especificado é gerenciado pelo componente Clustering de Failover da Microsoft. O disco deve estar no modo de manutenção do cluster e o recurso de cluster status deve estar online para executar essa operação. (41018)

O caminho de acesso solicitado já está em uso. (42002)

Não é possível atribuir caminhos de acesso a partições ocultas. (42004)

O caminho de acesso não é válido. (42007)

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Namespace	Root\Microsoft\Windows\Storage
MOF	Storagewmi.mof

Confira também

MSFT_Disk