Méthode IVdsVolumeMF::D eleteAccessPath (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 le chemin d’accès du volume actuel.
Syntaxe
HRESULT DeleteAccessPath(
[in] LPWSTR pwszPath,
[in] BOOL bForce
);
Paramètres
[in] pwszPath
Chaîne qui contient le chemin d’accès à supprimer. Un chemin d’accès peut être une lettre de lecteur ou un chemin d’accès à un répertoire vide sur un volume NTFS. S’il s’agit d’une lettre de lecteur, vous devez inclure une barre oblique inverse de fin, par exemple, « F : ». S’il s’agit d’un chemin d’accès à un répertoire, la barre oblique inverse de fin n’est pas requise, par exemple, « C:\MyFolder\MyDocuments ».
[in] bForce
Si la valeur est TRUE, le chemin d’accès est supprimé sans condition, même si le volume est en cours d’utilisation. Ce paramètre n’est significatif que lorsque le chemin d’accès est une lettre de lecteur.
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 |
|---|---|
|
La commande s'est correctement terminée. |
|
Le chemin d’accès mène au volume système, au volume de démarrage, au volume crashdump, au volume de mise en veille prolongée ou au volume pagefile. Vous ne pouvez pas supprimer la lettre de lecteur de ces volumes. |
|
Le chemin spécifié est introuvable. |
|
Le chemin d’accès a été supprimé avec succès, mais une erreur s’est produite. VDS n’a peut-être pas pu mettre à jour l’attribut de table de partition GUID (GPT) d’une partition ou n’a pas pu supprimer un partage réseau par défaut (tel que F$) lors de la suppression de la lettre de lecteur. |
|
Le volume a échoué. |
|
Le pack contenant le volume n’est pas accessible. |
Remarques
S’il n’y a pas de handles ouverts sur le volume, la lettre de lecteur est immédiatement supprimée. Toutefois, s’il existe des handles ouverts sur le volume, le volume ne peut pas être verrouillé et la lettre de lecteur est supprimée lors du redémarrage de l’ordinateur.
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 |