Méthode IVdsVolumeMF::AddAccessPath (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.]
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 |
|---|---|
|
Le chemin d’accès a été ajouté avec succès. |
|
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. |
|
Le volume a échoué. |
|
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 |