Funzione SetVolumeMountPointA (winbase.h)
Associa un volume a una lettera di unità o a una directory in un altro volume.
Sintassi
BOOL SetVolumeMountPointA(
[in] LPCSTR lpszVolumeMountPoint,
[in] LPCSTR lpszVolumeName
);
Parametri
[in] lpszVolumeMountPoint
Percorso in modalità utente da associare al volume. Può trattarsi di una lettera di unità (ad esempio, "X:\") o di una directory in un altro volume (ad esempio, "Y:\MountX"). La stringa deve terminare con una barra rovesciata finale ('').
[in] lpszVolumeName
Percorso GUID del volume per il volume. Questa stringa deve essere nel formato "\\?\Volume{GUID}" dove GUID è un GUID che identifica il volume. "\\?" disattiva l'analisi del percorso e viene ignorato come parte del percorso, come descritto in Denominazione di un volume.
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.
Se il parametro lpszVolumeMountPoint contiene un percorso di una cartella montata, GetLastError restituisce ERROR_DIR_NOT_EMPTY, anche se la directory è vuota.
Commenti
Quando questa funzione viene usata per associare un volume a una directory in un altro volume, la directory associata viene chiamata cartella montata.
Si tratta di un errore per associare un volume a una directory contenente file o sottodirectory. Questo errore si verifica per le directory di sistema e nascoste e per altre directory e si verifica per i file di sistema e nascosti.
Quando le cartelle montate vengono create in un volume in un disco cluster, possono essere eliminate in modo imprevisto in determinate circostanze. Per informazioni su come creare e configurare cartelle montate per assicurarsi che ciò non si verifichi, vedere Problemi di connessione del disco e dell'unità del cluster.
IIn 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) | No |
| Resilient File System (ReFS) | No |
SMB non supporta le funzioni di gestione dei volumi. Per CsvFS un nuovo punto di montaggio non verrà replicato negli altri nodi del cluster.
Esempio
Per un esempio, vedere Creazione di una cartella montata.
Nota
L'intestazione winbase.h definisce SetVolumeMountPoint 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
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winbase.h (include Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |