Funzione GetVolumePathNamesForVolumeNameA (winbase.h)

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

Sintassi

BOOL GetVolumePathNamesForVolumeNameA(
  [in]  LPCSTR lpszVolumeName,
  [out] LPCH   lpszVolumePathNames,
  [in]  DWORD  cchBufferLength,
  [out] PDWORD lpcchReturnLength
);

Parametri

[in] lpszVolumeName

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

[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 terminate da un carattere NULL aggiuntivo. Se il buffer non è abbastanza grande per contenere l'elenco completo, il buffer contiene la maggior parte possibile dell'elenco.

[in] cchBufferLength

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

[out] lpcchReturnLength

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

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 è sufficiente per 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