Méthode CreateClone de la classe MSFT_VirtualDisk

Crée un clone d’un disque virtuel, ce qui aboutit à un nouveau disque virtuel dont les données sont identiques à celles du disque virtuel d’origine.

Syntaxe

UInt32 CreateClone(
  [in]  String              FriendlyName,
  [in]  String              TargetStoragePoolName,
  [in]  Boolean             RunAsJob,
  [out] MSFT_StorageJob REF CreatedStorageJob,
  [out] String              CreatedVirtualDisk,
  [out] String              ExtendedStatus
);

Paramètres

FriendlyName [in]

Nom souhaité du clone de disque virtuel.

Ce paramètre est obligatoire et ne peut pas être NULL.

TargetStoragePoolName [in]

Pool de stockage qui doit être utilisé pour contenir le clone créé. Si ce paramètre n’est pas défini, cette méthode utilise par défaut le même pool de stockage que celui qui contient le disque virtuel source.

RunAsJob [in]

Si la valeur est TRUE, cette méthode utilise le paramètre CreatedStorageJob lorsque la maintenance de la requête prend beaucoup de temps. Si un travail de stockage a été créé pour suivre l’opération, cette méthode retourne paramètres de méthode vérifiés - Travail démarré.

Si la valeur est FALSE ou NULL, cette méthode suit le comportement asynchrone WMI par défaut, tel que déterminé par la méthode du client pour l’appel. En d’autres termes, elle est synchrone, sauf demande contraire.

CreatedStorageJob [out]

Si RunAsJob a la valeur TRUE et que cette méthode prend beaucoup de temps à s’exécuter, ce paramètre reçoit une référence à l’objet de travail de stockage utilisé pour suivre l’opération de longue durée.

CreatedVirtualDisk [out]

Si le disque virtuel est créé avec succès, ce paramètre reçoit une chaîne qui contient un objet MSFT_VirtualDisk incorporé.

ExtendedStatus [out]

Chaîne qui contient un objet MSFT_StorageExtendedStatus incorporé.

Ce paramètre permet au fournisseur de stockage de retourner des informations d’erreur étendues (spécifiques à l’implémentation).

Valeur retournée

Réussite (0)

Non pris en charge (1)

Erreur non spécifiée (2)

Délai d’expiration (3)

Échec (4)

Paramètre non valide (5)

Paramètres de méthode vérifiés - Travail démarré (4096)

Espace libre insuffisant (40000)

Accès refusé (40001)

Il n’y a pas suffisamment de ressources pour terminer l’opération. (40002)

Cache obsolète (40003)

Impossible de se connecter au fournisseur de stockage. (46000)

Le fournisseur de stockage ne peut pas se connecter au sous-système de stockage. (46001)

Cette opération n’est pas prise en charge sur les pools de stockage primordials. (48000)

Le pool de stockage est réservé à une utilisation spéciale uniquement. (48001)

Le pool de stockage spécifié est introuvable. (48005)

Le pool de stockage n’a pas pu terminer l’opération, car son intégrité ou son status opérationnelle ne le permet pas. (48006)

Remarques

Cette méthode crée un disque virtuel dont les données sont identiques à celles du disque virtuel source.

Configuration requise

Voir aussi

MSFT_VirtualDisk