Méthode Clear de la classe MSFT_Disk

Supprime les informations de partition et annule la initialisation d’un disque, ce qui le ramène à un état RAW.

Syntaxe

UInt32 Clear(
  [in]  Boolean RemoveData,
  [in]  Boolean RemoveOEM,
  [in]  Boolean ZeroOutEntireDisk,
  [out] String  ExtendedStatus
);

Paramètres

RemoveData [in]

TRUE s’il est possible de supprimer des partitions de données du disque. Si ce paramètre a la valeur FALSE ou NULL, cette méthode échoue en présence d’une partition de données.

RemoveOEM [in]

TRUE s’il est possible de supprimer OEM et d’autres partitions spéciales. Si ce paramètre a la valeur FALSE ou n’est pas spécifié, cette méthode échoue en présence de ces types de partitions.

ZeroOutEntireDisk [in]

TRUE si ce paramètre indique à cette méthode de supprimer l’intégralité du disque en plus de supprimer toutes les informations de partition. Si ce paramètre a la valeur FALSE ou NULL, seuls les premiers et derniers mégaoctets du disque sont mis à zéro.

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)

Le disque est en cours d’utilisation (6)

Accès refusé (40001)

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

Cache obsolète (40003)

Le disque n’a pas été initialisé. (41000)

Le disque est en lecture seule. (41002)

Le disque est hors connexion. (41003)

Impossible d’effacer avec des partitions OEM présentes. Pour effacer les partitions OEM, utilisez l’indicateur RemoveOEM. (41007)

Impossible d’effacer avec les partitions de données présentes. Pour effacer les partitions de données, utilisez l’indicateur RemoveData. (41008)

Opération non prise en charge sur un disque critique. (41009)

Il n’y a aucun média dans l’appareil. (41015)

L’objet spécifié est géré par le composant Microsoft Failover Clustering. Le disque doit être supprimé du cluster pour effectuer cette opération. (41019)

Remarques

L’appelant doit spécifier RemoveData, RemoveOEM ou les deux, sauf s’il supprime d’abord toutes les partitions de données, les partitions OEM connues et les partitions ESP sur le disque. Cette exigence exclut les partitions de métadonnées telles que MSR, la partition de métadonnées LDM et les partitions OEM inconnues.

Configuration requise

Voir aussi

MSFT_Disk