CREATE_PARTITION_PARAMETERS structure (vds.h)
[À compter de Windows 8 et Windows Server 2012, l’interface COM du service de disque virtuel est remplacée par l’API gestion du stockage Windows.]
Définit les paramètres de partition d’un style de partition.
Syntaxe
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;
Membres
style
MbrPartInfo
Paramètres d’un disque d’enregistrement de démarrage principal (MBR). Utilisé si le style est VDS_PST_MBR.
MbrPartInfo.partitionType
Indique le type de partition MBR défini par le système. Les valeurs possibles sont les suivantes :
MbrPartInfo.bootIndicator
Si la valeur est TRUE, la partition est active et peut être démarrée ; sinon, la partition ne peut pas être utilisée pour démarrer le système.
GptPartInfo
Paramètres d’un disque GPT (GUID Partition Table). Utilisé si le style est VDS_PST_GPT.
GptPartInfo.partitionType
GUID du type de partition.
| Valeur | Signification |
|---|---|
|
Il n’y a pas de partition.
Cet attribut peut être défini pour les disques de base et dynamiques. |
|
La partition est une partition système EFI.
Cet attribut peut être défini pour les disques de base et dynamiques. |
|
La partition est une partition réservée Microsoft.
Cet attribut peut être défini pour les disques de base et dynamiques. |
|
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 peut être définie uniquement 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. |
|
La partition est une partition de métadonnées LDM (Logical Disk Manager) sur un disque dynamique.
Cette valeur peut être définie uniquement pour les disques dynamiques. |
|
La partition est une partition de données LDM sur un disque dynamique.
Cette valeur peut être définie uniquement pour les disques dynamiques. |
|
La partition est une partition de récupération Microsoft.
Cet attribut peut être défini pour les disques de base et dynamiques. |
GptPartInfo.partitionId
SI ID de la partition. Si la valeur est GUID_NULL (0) lors de la création, une valeur unique est générée.
GptPartInfo.attributes
Attributs de la partition. Il peut s’agir de l’une ou plusieurs des valeurs suivantes :
| Valeur | Signification |
|---|---|
|
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. |
|
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. |
|
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 les 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. |
|
Si cet attribut est défini, la partition est un cliché instantané d’une autre partition.
Cet attribut est utilisé par le service VSS (Volume Shadow Copy). 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. Par exemple, une application qui effectue une récupération rapide interrompt un numéro d’unité logique de cliché instantané en effaçant les attributs en lecture seule et masqués, 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. |
|
Si cet attribut est défini, la partition est en lecture seule.
Toutes les demandes d’écriture dans la partition échouent. VSS utilise cet attribut. Ne définissez pas cet attribut pour les disques dynamiques. Sa définition peut entraîner des erreurs d’E/S et empêcher le système de fichiers de se monter correctement. |
GptPartInfo.name[36]
Chaîne Unicode terminée par null qui spécifie le nom de la partition.
Remarques
La méthode IVdsAdvancedDisk ::CreatePartition transmet cette structure en tant qu’argument pour spécifier un ensemble de paramètres.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| En-tête | vds.h |