Funzione SetVolumeMountPointA (winbase.h)

Articolo
08/27/2023

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