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
Un volume GUID chemin d’accès pour le volume. Cette chaîne doit être de la forme « \\ ?\Volume{GUID}\ » où GUID est un GUID qui identifie le volume. « \\ ?\ » désactive l’analyse du chemin d’accès et est ignorée dans le cadre du chemin, comme indiqué dans nommage d’un volume.
Valeur de retour
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’erreur étendues, 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é.
Il s’agit d’une erreur d’association d’un volume à un répertoire qui contient des fichiers ou des sous-répertoires. Cette erreur se produit pour les répertoires système et masqués, ainsi que d’autres répertoires, et cela 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 de cluster et de lecteur.
IIn Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.
| Technologie | Supporté |
|---|---|
| Protocole SMB (Server Message Block) 3.0 | Non |
| Basculement transparent SMB 3.0 (TFO) | Non |
| SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO) | Non |
| Cluster Shared Volume File System (CsvFS) | Non |
| Système de fichiers résilient (ReFS) | Non |
SMB ne prend pas en charge les fonctions de gestion des volumes. Pour CsvFS, un nouveau point de montage ne sera pas répliqué vers les autres nœuds du cluster.
Exemples
Pour obtenir un exemple, consultez Création d’un dossier monté.
Note
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. Le mélange 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows XP [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | winbase.h (inclure Windows.h) |
| bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |