IVdsAdvancedDisk::Clean, méthode (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.]

Supprime les informations de partition et ne initialise pas les disques de base ou dynamiques.

Windows Server 2003 : La méthode Clean n’est pas prise en charge pour les appareils amovibles.

Syntaxe

HRESULT Clean(
  [in]  BOOL      bForce,
  [in]  BOOL      bForceOEM,
  [in]  BOOL      bFullClean,
  [out] IVdsAsync **ppAsync
);

Paramètres

[in] bForce

Si la valeur est TRUE, nettoie un disque contenant des volumes de données ou des partitions ESP.

[in] bForceOEM

Si la valeur est TRUE, nettoie un disque MBR contenant les partitions OEM connues dans le tableau suivant ou nettoie un disque basé sur GPT contenant n’importe quelle partition OEM. Une partition OEM a l’indicateur GPT_ATTRIBUTE_PLATFORM_REQUIRED défini sur un disque gpT.

Type de partition	Description
0x12	Une partition EISA.
0x84	Partition de mise en veille prolongée pour les ordinateurs portables.
0xA0	Partition de diagnostic pour certains ordinateurs portables HP.
0xDE	Partition définie par Dell.
0xFE	Une partition IBM IML.

[in] bFullClean

Si la valeur est TRUE, nettoie l’ensemble du disque en remplaçant les données de chaque secteur par des zéros ; sinon, cette méthode nettoie uniquement le premier et le dernier mégaoctets sur le disque.

[out] ppAsync

Adresse d’un pointeur vers le 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	Les données ont été supprimées avec succès et le disque n’a pas été initialisé.
VDS_E_NO_MEDIA 0x80042412L	Il n’existe aucun média dans l’appareil amovible.
VDS_E_MISSING_DISK 0x80042454L	Le disque est manquant.
VDS_E_OPERATION_DENIED 0x8004240AL	L’opération a échoué dans l’une des conditions suivantes : Le disque contient une partition OEM et bForceOEM est false. Le disque contient un volume ou une partition ESP et bForce a la valeur FALSE. Le disque contient l’un des volumes système, que bForce ait la valeur TRUE ou FALSE. Un volume système peut être l’un des éléments suivants : Volume contenant le chargeur de système d’exploitation. Volume de démarrage, qui contient le répertoire system32. Volume contenant le fichier pagefile ou le fichier de mise en veille prolongée, ou un volume utilisé comme vidage sur incident. Partition ESP (partition à partir de laquelle le système démarre).
VDS_S_DISK_PARTIALLY_CLEANED 0x0004241AL	La table de partition est nettoyée, mais tous les secteurs ne sont pas nettoyés pendant un nettoyage complet. Certains secteurs du premier mégaoctet et du dernier mégaoctet sont également nettoyés; toutefois, à moins que le nettoyage soit entièrement propre, les secteurs restants ne sont pas nettoyés.

Remarques

Avant d’appeler cette méthode, l’appelant doit démonter tous les volumes montés sur le disque en appelant IVdsVolumeMF::D ismount pour chaque volume.

Utilisez le paramètre bForce , le paramètre bForceOEM ou les deux avec cette méthode, sauf si vous supprimez d’abord tous les volumes 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.

Windows Server 2003 : La méthode Clean n’est pas prise en charge pour les appareils amovibles.

Les implémenteurs doivent retourner un pointeur vers l’interface IVdsAsync pour cette méthode, que l’appel lance ou non une opération asynchrone.

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

Objet Disk

IVdsAdvancedDisk

IVdsAsync

Partager via