SetVolumeLabelA, fonction (winbase.h)
Définit l’étiquette d’un volume de système de fichiers.
Syntaxe
BOOL SetVolumeLabelA(
[in, optional] LPCSTR lpRootPathName,
[in, optional] LPCSTR lpVolumeName
);
Paramètres
[in, optional] lpRootPathName
Pointeur vers une chaîne qui contient la lettre de lecteur du volume (par exemple, X :) ou le chemin d’accès d’un dossier monté associé au volume (par exemple, Y :\MountX). La chaîne doit se terminer par une barre oblique inverse de fin (''). Si ce paramètre a la valeur NULL, la racine du répertoire actif est utilisée.
[in, optional] lpVolumeName
Pointeur vers une chaîne qui contient la nouvelle étiquette du volume. Si ce paramètre a la valeur NULL, la fonction supprime toute étiquette existante du volume spécifié et n’attribue pas de nouvelle étiquette.
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.
Remarques
La longueur maximale de l’étiquette de volume est de 32 caractères.
Systèmes de fichiers FAT : La longueur maximale de l’étiquette de volume est de 11 caractères.
Une étiquette est un nom convivial qu’un utilisateur affecte à un volume pour le rendre plus facile à reconnaître. Un volume peut avoir une étiquette, une lettre de lecteur, les deux ou aucun des deux. Pour plus d’informations, consultez Affectation de noms à un volume.
Dans 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) | No |
| Système de fichiers du volume partagé de cluster (CsvFS) | Oui |
| Système de fichiers résilient (ReFS) | Oui |
SMB ne prend pas en charge les fonctions de gestion des volumes.
Notes
L’en-tête winbase.h définit SetVolumeLabel 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
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau | applications UWP] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau | applications UWP] |
| Plateforme cible | Windows |
| En-tête | winbase.h (inclure Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |