Funzione GetVolumeNameForVolumeMountPointW (fileapi.h)
Recupera un percorso GUID del volume per il volume associato al punto di montaggio del volume specificato ( lettera di unità, percorso GUID del volume o cartella montata).
Sintassi
BOOL GetVolumeNameForVolumeMountPointW(
[in] LPCWSTR lpszVolumeMountPoint,
[out] LPWSTR lpszVolumeName,
[in] DWORD cchBufferLength
);
Parametri
[in] lpszVolumeMountPoint
Puntatore a una stringa che contiene il percorso di una cartella montata (ad esempio, "Y:\MountX\") o una lettera di unità (ad esempio, "X:\"). La stringa deve terminare con una barra rovesciata finale ('\').
[out] lpszVolumeName
Puntatore a una stringa che riceve il percorso GUID del volume. Questo percorso è nel formato "\?\Volume{GUID}\" dove GUID è un GUID che identifica il volume. Se è presente più di un percorso GUID del volume per il volume, viene restituito solo il primo percorso nella cache del gestore di montaggio.
[in] cchBufferLength
Lunghezza del buffer di output, in TCHAR. Una dimensione ragionevole per il buffer per contenere il percorso GUID del volume più grande possibile è di 50 caratteri.
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
Usare GetVolumeNameForVolumeMountPoint per ottenere un percorso GUID del volume da usare con funzioni quali SetVolumeMountPoint e FindFirstVolumeMountPoint che richiedono un percorso GUID del volume come parametro di input. Per altre informazioni sui percorsi GUID del volume, 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) | No |
SMB non supporta le funzioni di gestione dei volumi.
I punti di montaggio non sono supportati dai volumi ReFS.
Requisiti
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | fileapi.h (include Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |