Méthode IVdsVolumeMF::D eleteAccessPath (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 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
S_OK	La commande s'est correctement terminée.
VDS_E_OPERATION_DENIED 0x8004240AL	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.
VDS_E_PATH_NOT_FOUND 0x80042416L	Le chemin spécifié est introuvable.
VDS_E_DEVICE_IN_USE 0x80042413L	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.
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	Le volume a échoué.
VDS_E_PACK_OFFLINE 0x80042444L	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

Voir aussi

IVdsVolumeMF

IVdsVolumeMF::AddAccessPath

IVdsVolumeMF::QueryAccessPaths

Partager via