Funzione GetVolumePathNamesForVolumeNameW (fileapi.h)

  • Articolo

Recupera un elenco di lettere di unità e percorsi di cartella montati per il volume specificato.

Sintassi

BOOL GetVolumePathNamesForVolumeNameW(
  [in]  LPCWSTR lpszVolumeName,
  [out] LPWCH   lpszVolumePathNames,
  [in]  DWORD   cchBufferLength,
  [out] PDWORD  lpcchReturnLength
);

Parametri

[in] lpszVolumeName

Percorso GUID del volume per il volume. Un percorso GUID del volume è nel formato "\\?\Volume{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}\".

[out] lpszVolumePathNames

Puntatore a un buffer che riceve l'elenco di lettere di unità e percorsi di cartella montati. L'elenco è una matrice di stringhe con terminazione Null con un carattere NULL aggiuntivo. Se il buffer non è sufficientemente grande da contenere l'elenco completo, il buffer contiene la maggior parte dell'elenco possibile.

[in] cchBufferLength

Lunghezza del buffer lpszVolumePathNames , in TCHAR, inclusi tutti i caratteri NULL .

[out] lpcchReturnLength

Se la chiamata ha esito positivo, questo parametro corrisponde al numero di TCHAR copiati nel buffer lpszVolumePathNames . In caso contrario, questo parametro è la dimensione del buffer necessaria per contenere l'elenco completo, in TCHAR.

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 buffer non è sufficientemente grande da contenere l'elenco completo, il codice di errore è ERROR_MORE_DATA e il parametro lpcchReturnLength riceve le dimensioni del buffer necessarie.

Commenti

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.

Esempio

Per un esempio, vedere Visualizzazione dei percorsi del volume.

Requisiti

Requisito Valore
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

Cartelle montate

Funzioni di gestione dei volumi