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)
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

Vedere anche

DeleteVolumeMountPoint

GetVolumePathName

Cartelle montate

SetVolumeMountPoint

Funzioni di gestione dei volumi