IVdsAdvancedDisk::Clean, méthode (vds.h)
[À 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 |
|---|---|
|
Les données ont été supprimées avec succès et le disque n’a pas été initialisé. |
|
Il n’existe aucun média dans l’appareil amovible. |
|
Le disque est manquant. |
|
L’opération a échoué dans l’une des conditions suivantes :
|
|
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 |