structure CHANGE_ATTRIBUTES_PARAMETERS (vds.h)

Article
03/08/2023

[À 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 _CHANGE_ATTRIBUTES_PARAMETERS {
  VDS_PARTITION_STYLE style;
  union {
    struct {
      BOOLEAN bootIndicator;
    } MbrPartInfo;
    struct {
      ULONGLONG attributes;
    } GptPartInfo;
  };
} CHANGE_ATTRIBUTES_PARAMETERS;

Membres

style

Détermine les paramètres de partition. Les valeurs prises en charge sont VDS_PST_MBR ou VDS_PST_GPT.

MbrPartInfo

Utilisé si le style est VDS_PST_MBR. Paramètres d’un disque MBR (Master Boot Record).

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

Utilisé si le style est VDS_PST_GPT. Paramètres d’un disque GPT (GUID Partition Table).

GptPartInfo.attributes

Attributs de la partition. Il peut s’agir de l’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 que le disque est vu pour la première fois par un ordinateur. Cet attribut est utile dans les environnements SAN. 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. 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. Une application qui effectue une récupération rapide, par exemple, interrompt une lun de cliché instantané en supprimant 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. Toutes les demandes d’écriture 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.

Remarques

La méthode IVdsAdvancedDisk::ChangeAttributes prend cette structure en tant que paramètre.

Configuration requise


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

Voir aussi

IVdsAdvancedDisk::ChangeAttributes

VDS Structures

Partager via