Partager via

Méthode IVdsVolumeMF::AddAccessPath (vds.h)

  • Article

[À 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.]

Ajoute un chemin d’accès.

Syntaxe

HRESULT AddAccessPath(
  [in] LPWSTR pwszPath
);

Paramètres

[in] pwszPath

Chaîne indiquant le chemin d’accès, qui est un chemin d’accès en mode utilisateur qui peut être utilisé pour ouvrir le volume. 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. La chaîne de chemin d’accès doit inclure une barre oblique inverse de fin, par exemple, « F: ».

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
 Le chemin d’accès a été ajouté avec succès.
S_FALSE
 Le chemin d’accès a été ajouté avec succès, mais une erreur s’est produite. VDS n’a peut-être pas pu mettre à jour l’attribut GPT_BASIC_DATA_ATTRIBUTE_NO_DRIVE_LETTER d’une partition ou n’a pas pu ajouter un partage réseau par défaut (tel que F$) lors de l’ajout de la lettre de lecteur. Pour plus d’informations, consultez PARTITION_INFORMATION_GPT.
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

VDS ajoute le chemin d’accès en créant un dossier monté (également appelé point de montage de volume). Notez que les dossiers montés sont pris en charge uniquement sur les volumes NTFS. Pour plus d’informations, consultez Dossiers montés.

Cette méthode retourne ERROR_DIR_NOT_EMPTY si le paramètre pwszPath contient un chemin d’accès à un dossier monté déjà en cours d’utilisation (même si le répertoire est vide) ou si pwszPath contient un chemin d’accès à un répertoire vide.

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

SetVolumeMountPoint