SetVolumeMountPointA, fonction (winbase.h)
Associe un volume à une lettre de lecteur ou à un répertoire sur un autre volume.
Syntaxe
BOOL SetVolumeMountPointA(
[in] LPCSTR lpszVolumeMountPoint,
[in] LPCSTR lpszVolumeName
);
Paramètres
[in] lpszVolumeMountPoint
Chemin d’accès en mode utilisateur à associer au volume. Il peut s’agir d’une lettre de lecteur (par exemple, « X:\ ») ou d’un répertoire sur un autre volume (par exemple, « Y:\MountX »). La chaîne doit se terminer par une barre oblique inverse de fin ('').
[in] lpszVolumeName
Chemin d’accès GUID du volume. Cette chaîne doit avoir la forme « \\?\Volume{GUID} », où GUID est un GUID qui identifie le volume. « \\? » désactive l’analyse du chemin et est ignoré dans le cadre du chemin d’accès, comme indiqué dans Nommage d’un volume.
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Si le paramètre lpszVolumeMountPoint contient un chemin d’accès à un dossier monté, GetLastError retourne ERROR_DIR_NOT_EMPTY, même si le répertoire est vide.
Remarques
Lorsque cette fonction est utilisée pour associer un volume à un répertoire sur un autre volume, le répertoire associé est appelé dossier monté.
L’association d’un volume à un répertoire contenant des fichiers ou des sous-répertoires est une erreur. Cette erreur se produit pour les répertoires système et masqués, ainsi que pour d’autres répertoires, et elle se produit pour les fichiers système et masqués.
Lorsque des dossiers montés sont créés sur un volume sur un disque en cluster, ils peuvent être supprimés de manière inattendue dans certaines circonstances. Pour plus d’informations sur la création et la configuration de dossiers montés pour vous assurer que cela ne se produit pas, consultez Problèmes de connexion de disque et de lecteur de cluster.
IDans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.
| Technologie | Prise en charge |
|---|---|
| Protocole Server Message Block (SMB) 3.0 | No |
| Basculement transparent SMB 3.0 (TFO) | No |
| SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO) | Non |
| Système de fichiers du volume partagé de cluster (CsvFS) | No |
| Système de fichiers résilient (ReFS) | No |
SMB ne prend pas en charge les fonctions de gestion des volumes. Pour CsvFS, un nouveau point de montage n’est pas répliqué sur les autres nœuds du cluster.
Exemples
Pour obtenir un exemple, consultez Création d’un dossier monté.
Notes
L’en-tête winbase.h définit SetVolumeMountPoint comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Configuration requise
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | winbase.h (inclure Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |