Funzione GetVolumePathNamesForVolumeNameW (fileapi.h)

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.

SMB non supporta le funzioni di gestione dei volumi.

Esempio

Per un esempio, vedere Visualizzazione dei percorsi del volume.

Requisiti

Vedere anche

Cartelle montate

Funzioni di gestione dei volumi