Funzione GetVolumePathNamesForVolumeNameW (fileapi.h)

Articolo
11/20/2024

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

Sintassi

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

Parametri

[in] lpszVolumeName

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

[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 da 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 WCHARs, inclusi tutti i caratteri NULL.

[out] lpcchReturnLength

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

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 ottenere informazioni estese 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.

Osservazioni

In Windows 8 e Windows Server 2012 questa funzione è supportata dalle tecnologie seguenti.

Tecnologia	Sostenuto
Protocollo SMB (Server Message Block) 3.0	No
SMB 3.0 Transparent Failover (TFO)	No
SMB 3.0 con condivisioni file con scalabilità orizzontale (SO)	No
Cluster Shared Volume File System (CsvFS)	Sì
Resilient File System (ReFS)	Sì

SMB non supporta le funzioni di gestione dei volumi.

Esempi

Per un esempio, vedere Visualizzazione dei percorsi del volume.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	fileapi.h (include Windows.h)
libreria	Kernel32.lib
dll	Kernel32.dll

Vedere anche

cartelle montate

funzioni di gestione dei volumi

Condividi tramite