SetVolumeMountPointA, fonction (winbase.h)

Article
08/27/2023

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