structure PARTITION_INFORMATION_GPT (winioctl.h)

Contient des informations de partition de table de partition GUID (GPT).

Syntaxe

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

Membres

PartitionType

GUID qui identifie le type de partition.

Chaque type de partition pris en charge par la spécification EFI est identifié par son propre GUID, qui est publié par le développeur de la partition.

Ce membre peut être l’une des valeurs suivantes.

Valeur Signification
PARTITION_BASIC_DATA_GUID
ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
Type de partition de données créé et reconnu par Windows.

Seules les partitions de ce type peuvent recevoir des lettres de lecteur, recevoir des chemins GUID de volume, héberger des dossiers montés (également appelés points de montage de volume) et être énumérées par des appels à FindFirstVolume et FindNextVolume.

Cette valeur ne peut être définie que pour les disques de base, à une exception près. Si PARTITION_BASIC_DATA_GUID et GPT_ATTRIBUTE_PLATFORM_REQUIRED sont définis pour une partition sur un disque de base qui est ensuite converti en disque dynamique, la partition reste une partition de base, même si le reste du disque est un disque dynamique. En effet, la partition est considérée comme une partition OEM sur un disque GPT.

PARTITION_ENTRY_UNUSED_GUID
00000000-0000-0000-0000-000000000000
Il n’y a pas de partition.

Cette valeur peut être définie pour les disques de base et dynamiques.

PARTITION_SYSTEM_GUID
c12a7328-f81f-11d2-ba4b-00a0c93ec93b
La partition est une partition système EFI.

Cette valeur peut être définie pour les disques de base et dynamiques.

PARTITION_MSFT_RESERVED_GUID
e3c9e316-0b5c-4db8-817d-f92df00215ae
La partition est une partition réservée Microsoft.

Cette valeur peut être définie pour les disques de base et dynamiques.

PARTITION_LDM_METADATA_GUID
5808c8aa-7e8f-42e0-85d2-e1e90434cfb3
La partition est une partition de métadonnées LDM (Logical Disk Manager) sur un disque dynamique.

Cette valeur ne peut être définie que pour les disques dynamiques.

PARTITION_LDM_DATA_GUID
af9b60a0-1431-4f62-bc68-3311714a69ad
La partition est une partition de données LDM sur un disque dynamique.

Cette valeur ne peut être définie que pour les disques dynamiques.

PARTITION_MSFT_RECOVERY_GUID
de94bba4-06d1-4d40-a16a-bfd50179d6ac
La partition est une partition de récupération Microsoft.

Cette valeur peut être définie pour les disques de base et dynamiques.

PartitionId

GUID de la partition.

Attributes

Attributs EFI (Extensible Firmware Interface) de la partition.

Ce membre peut être une ou plusieurs des valeurs suivantes.

Valeur Signification
GPT_ATTRIBUTE_PLATFORM_REQUIRED
0x0000000000000001
Si cet attribut est défini, la partition est requise par un ordinateur pour fonctionner correctement.

Par exemple, cet attribut doit être défini pour les partitions OEM. Notez que si cet attribut est défini, vous pouvez utiliser l’utilitaire DiskPart.exe pour effectuer des opérations de partition telles que la suppression de la partition. Toutefois, étant donné que la partition n’est pas un volume, vous ne pouvez pas utiliser l’utilitaire DiskPart.exe pour effectuer des opérations de volume sur la partition.

Cet attribut peut être défini pour les disques de base et dynamiques. Si elle est définie pour une partition sur un disque de base et que le disque est converti en disque dynamique, la partition reste une partition de base, même si le reste du disque est un disque dynamique. En effet, la partition est considérée comme une partition OEM sur un disque GPT.

GPT_BASIC_DATA_ATTRIBUTE_NO_DRIVE_LETTER
0x8000000000000000
Si cet attribut est défini, la partition ne reçoit pas de lettre de lecteur par défaut lorsque le disque est déplacé vers un autre ordinateur ou lorsque le disque est vu pour la première fois par un ordinateur.

Cet attribut est utile dans les environnements SAN (Storage Area Network).

Malgré son nom, cet attribut peut être défini pour les disques de base et dynamiques.

GPT_BASIC_DATA_ATTRIBUTE_HIDDEN
0x4000000000000000
Si cet attribut est défini, la partition n’est pas détectée par le Gestionnaire de montage.

Par conséquent, la partition ne reçoit pas de lettre de lecteur, ne reçoit pas de chemin d’accès GUID de volume, n’héberge pas de dossiers montés (également appelés points de montage de volume) et n’est pas énumérée par les appels à FindFirstVolume et FindNextVolume. Cela garantit que les applications telles que Le défragmenteur de disque n’accèdent pas à la partition. Le service VSS (Volume Shadow Copy Service) utilise cet attribut.

Malgré son nom, cet attribut peut être défini pour les disques de base et dynamiques.

GPT_BASIC_DATA_ATTRIBUTE_SHADOW_COPY
0x2000000000000000
Si cet attribut est défini, la partition est un cliché instantané d’une autre partition.

VSS utilise cet attribut. Cet attribut est une indication pour les logiciels basés sur un pilote de filtre de système de fichiers (tels que les programmes antivirus) afin d’éviter l’attachement au volume.

Une application peut utiliser l’attribut pour différencier un volume de cliché instantané d’un volume de production. Une application qui effectue une récupération rapide, par exemple, interrompt une LUN de cliché instantané et efface les attributs masqués et en lecture seule, ainsi que cet attribut. Cet attribut est défini lorsque le cliché instantané est créé et effacé lorsque le cliché instantané est rompu.

Malgré son nom, cet attribut peut être défini pour les disques de base et dynamiques.

Windows Server 2003 : Cet attribut n’est pas pris en charge avant Windows Server 2003 avec SP1.

GPT_BASIC_DATA_ATTRIBUTE_READ_ONLY
0x1000000000000000
Si cet attribut est défini, la partition est en lecture seule.

Les écritures dans la partition échouent. IOCTL_DISK_IS_WRITABLE échoue avec le code d’erreur Win32 ERROR_WRITE_PROTECT , ce qui entraîne le montage du système de fichiers en lecture seule, si un système de fichiers est présent.

VSS utilise cet attribut.

Ne définissez pas cet attribut pour les disques dynamiques. Sa définition peut provoquer des erreurs d’E/S et empêcher le système de fichiers de se monter correctement.

Name[36]

Chaîne à caractères larges qui décrit la partition.

Remarques

Le format de partition GPT est requis pour les disques utilisés pour démarrer les ordinateurs qui utilisent le microprogramme EFI (Extended Firmware Interface). Les disques de données GPT peuvent résider sur des architectures x86, x64 et Itanium.

À compter de Windows Server 2003 avec SP1, gpT est pris en charge sur toutes les plateformes Windows, et pas uniquement sur les plateformes qui utilisent EFI.

Configuration requise

   
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
En-tête winioctl.h (inclure Windows.h)

Voir aussi

Reconnaissance du système de fichiers

IOCTL_DISK_GET_PARTITION_INFO_EX

IOCTL_DISK_SET_PARTITION_INFO_EX

PARTITION_INFORMATION_EX