Funzione SetVolumeLabelW (winbase.h)
Imposta l'etichetta di un volume del file system.
Sintassi
BOOL SetVolumeLabelW(
[in, optional] LPCWSTR lpRootPathName,
[in, optional] LPCWSTR lpVolumeName
);
Parametri
[in, optional] lpRootPathName
Puntatore a una stringa contenente la lettera di unità del volume (ad esempio, X:) o il percorso di una cartella montata associata al volume ,ad esempio Y:\MountX. La stringa deve terminare con una barra rovesciata finale (''). Se questo parametro è NULL, viene utilizzata la radice della directory corrente.
[in, optional] lpVolumeName
Puntatore a una stringa che contiene la nuova etichetta per il volume. Se questo parametro è NULL, la funzione elimina qualsiasi etichetta esistente dal volume specificato e non assegna una nuova etichetta.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
La lunghezza massima dell'etichetta del volume è di 32 caratteri.
File system FAT: La lunghezza massima dell'etichetta del volume è di 11 caratteri.
Un'etichetta è un nome descrittivo assegnato da un utente a un volume per semplificare il riconoscimento. Un volume può avere un'etichetta, una lettera di unità, entrambe o nessuna delle due. Per altre informazioni, vedere Denominazione di un volume.
In Windows 8 e Windows Server 2012 questa funzione è supportata dalle tecnologie seguenti.
| Tecnologia | Supportato |
|---|---|
| Protocollo SMB (Server Message Block) 3.0 | No |
| Failover trasparente SMB 3.0 (TFO) | No |
| SMB 3.0 con condivisioni file di scalabilità orizzontale (SO) | No |
| File system del volume condiviso cluster (CsvFS) | Sì |
| Resilient File System (ReFS) | Sì |
SMB non supporta le funzioni di gestione dei volumi.
Nota
L'intestazione winbase.h definisce SetVolumeLabel come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2003 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | winbase.h (include Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |