estrutura PARTITION_INFORMATION_GPT (winioctl.h)

Contém informações de partição GPT (tabela de partição GUID).

Sintaxe

typedef struct _PARTITION_INFORMATION_GPT {
  GUID    PartitionType;
  GUID    PartitionId;
  DWORD64 Attributes;
  WCHAR   Name[36];
} PARTITION_INFORMATION_GPT, *PPARTITION_INFORMATION_GPT;

Membros

PartitionType

Um GUID que identifica o tipo de partição.

Cada tipo de partição compatível com a especificação EFI é identificado por seu próprio GUID, que é publicado pelo desenvolvedor da partição.

Esse membro pode ser um dos valores a seguir.

Valor Significado
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 continuará sendo 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_ENTRY_UNUSED_GUID
00000000-0000-0000-0000-000000000000
Não há partição.

Esse valor 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 valor 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 valor pode ser definido para discos básicos e dinâmicos.

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 só pode ser definido 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 valor pode ser definido para discos básicos e dinâmicos.

PartitionId

O GUID da partição.

Attributes

Os atributos EFI (Extensible Firmware Interface) da partição.

Esse membro pode ser um ou mais dos valores a seguir.

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 a exclusão da 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 estiver definido, a partição não receberá uma letra da unidade por padrão quando o disco é movido para outro computador ou quando o disco é 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 Mount Manager.

Como resultado, a partição não recebe uma letra de 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ópia 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 estiver definido, a partição será uma cópia de sombra de outra partição.

O VSS usa esse atributo. Esse atributo é uma indicação para 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. Um aplicativo que faz uma recuperação rápida, por exemplo, interromperá um LUN de cópia de sombra e limpará 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: Esse atributo não tem suporte antes do Windows Server 2003 com o SP1.

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

As gravações 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.

Name[36]

Uma cadeia de caracteres largos que descreve a partição.

Comentários

O formato de partição GPT é necessário para discos usados para inicializar computadores que usam firmware EFI (Interface de Firmware Estendido). Os discos de dados GPT podem residir em arquiteturas baseadas em x86, x64 e Itanium.

A partir do Windows Server 2003 com o SP1, o GPT tem suporte em todas as plataformas Windows, não apenas nas plataformas que usam o EFI.

Requisitos

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho winioctl.h (inclua Windows.h)

Confira também

Reconhecimento do sistema de arquivos

IOCTL_DISK_GET_PARTITION_INFO_EX

IOCTL_DISK_SET_PARTITION_INFO_EX

PARTITION_INFORMATION_EX