Méthode IVdsAdvancedDisk::CreatePartition (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.]

Crée une partition sur un disque de base.

La méthode IVdsCreatePartitionEx::CreatePartitionEx remplace cette méthode.

Syntaxe

HRESULT CreatePartition(
  [in]  ULONGLONG                   ullOffset,
  [in]  ULONGLONG                   ullSize,
  [in]  CREATE_PARTITION_PARAMETERS *para,
  [out] IVdsAsync                   **ppAsync
);

Paramètres

[in] ullOffset

Décalage de partition.

[in] ullSize

Taille, en octets, de la nouvelle partition.

[in] para

Pointeur vers les paramètres définis par la structure CREATE_PARTITION_PARAMETERS .

[out] ppAsync

Adresse d’un pointeur d’interface IVdsAsync , que VDS initialise au retour. Les appelants doivent libérer l’interface. Utilisez ce pointeur pour annuler, attendre ou interroger l’état de l’opération.

Valeur retournée

Cette méthode peut retourner des valeurs HRESULT standard, telles que E_INVALIDARG ou E_OUTOFMEMORY, et des valeurs de retour spécifiques à VDS. Il peut également retourner des codes d’erreur système convertis à l’aide de la macro HRESULT_FROM_WIN32 . Les erreurs peuvent provenir de VDS lui-même ou du fournisseur VDS sous-jacent utilisé. Les valeurs de retour possibles sont les suivantes.

Code/valeur de retour	Description
S_OK	La partition a été créée avec succès.
VDS_E_NO_MEDIA 0x80042412L	Il n’existe aucun média dans un lecteur amovible.
VDS_E_INVALID_OPERATION 0x80042415L	Le média ne prend pas en charge cette opération. Par exemple, l’appelant ne peut pas créer une partition sur un CD-ROM.
VDS_E_NOT_SUPPORTED 0x80042400L	La création d’une deuxième partition sur un support amovible n’est pas prise en charge. Cette erreur indique également que le disque est un disque dynamique.
VDS_E_PARTITION_LIMIT_REACHED 0x80042407L	Le nombre maximal de partitions (quatre principales, ou trois principales et une étendue) existe déjà lorsque l’appelant tente de créer une partition principale ou une partition étendue supplémentaire.
VDS_S_UPDATE_BOOTFILE_FAILED 0x00042434L	La partition a été créée correctement, mais VDS n’a pas pu mettre à jour les options de démarrage dans le magasin de données de configuration de démarrage (BCD). Windows Server 2003 : Les options de démarrage sont stockées dans le fichier boot.ini sur un système x86 ou x64 ou nvRAM sur un système Itanium.

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]
Plateforme cible	Windows
En-tête	vds.h
Bibliothèque	Uuid.lib

Voir aussi

CREATE_PARTITION_PARAMETERS

Objet Disk

IVdsAdvancedDisk

IVdsAsync

IVdsCreatePartitionEx::CreatePartitionEx

Partager via