Méthode IVdsServiceUninstallDisk ::UninstallDisks (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.]
Désinstalle un ensemble de disques.
Syntaxe
HRESULT UninstallDisks(
[in] VDS_OBJECT_ID *pDiskIdArray,
[in] ULONG ulCount,
[in] BOOLEAN bForce,
[out] BOOLEAN *pbReboot,
[out] HRESULT *pResults
);
Paramètres
[in] pDiskIdArray
Adresse d’une mémoire tampon contenant un tableau d’ID d’objet VDS, un pour chaque disque à désinstaller. Chaque ID du tableau doit être unique.
[in] ulCount
Nombre d’ID d’objet VDS dans la mémoire tampon vers laquelle pointe le paramètre pDiskIdArray .
[in] bForce
Si la valeur est TRUE, VDS désinstalle les disques même si les volumes ne peuvent pas être verrouillés ou démontés.
[out] pbReboot
Adresse d’une variable BOOLEAN qui reçoit TRUE si l’utilisateur doit redémarrer l’ordinateur pour terminer le processus de désinstallation.
[out] pResults
Adresse d’un tableau de valeurs HRESULT allouées par l’appelant. Le nombre d’éléments dans le tableau est pointé vers le paramètre pDiskIdArray . Le premier élément de ce tableau correspond au premier élément du pDiskIdArray, et ainsi de suite. Si l’un des disques ne parvient pas à s’initialiser correctement, le code d’erreur spécifique de l’échec est retourné dans l’élément correspondant de ce tableau.
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 disques ont été correctement désinstallés. |
|
Cette méthode a retourné un code d’avertissement ou d’erreur pour un ou plusieurs disques. |
|
Les disques ont été correctement désinstallés, mais les attributs de la table de partition GUID (GPT) n’ont pas pu être récupérés pour un ou plusieurs disques. |
|
VDS a rencontré une erreur interne. Consultez le journal des événements pour plus d'informations. |
|
Un ou plusieurs disques étaient manquants. |
|
Le chemin d’accès n’a pas pu être récupéré pour un ou plusieurs disques. |
|
Le chemin d’accès n’a pas pu être récupéré pour un ou plusieurs volumes. |
|
Un ou plusieurs des ID d’objet VDS spécifiés correspondent à des disques qui ne sont plus présents. |
|
Un ou plusieurs des ID d’objet VDS spécifiés correspondent à des disques qui n’existent pas. |
|
Le cache du fournisseur n’est pas synchronisé avec le cache des pilotes. |
Remarques
VDS implémente cette méthode.
Cette méthode, synchrone, désinstalle d’abord les volumes sur les disques spécifiés, puis désinstalle les disques. Une fois les disques désinstallés, les LUN correspondantes peuvent être masquées (masquées) ou supprimées.
Cette méthode nettoie les lettres de lecteur qui ont été affectées aux volumes sur les disques. En outre, il définit les volumes hors connexion pour empêcher le montage d’un volume après la fermeture du handle de démontage, mais avant la suppression du disque.
Lorsque vous supprimez un volume dynamique qui s’étend sur plusieurs disques, vous devez appeler cette méthode au lieu d’utiliser des fonctions de gestionnaire de périphériques.
Pour obtenir des instructions sur la désinstallation d’un disque sur les versions de Windows Server 2003 où la méthode UninstallDisks n’est pas prise en charge, consultez la section Remarques de la méthode IVdsLun ::SetMask .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 R2 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | vds.h |
| Bibliothèque | Uuid.lib |