Funzione FindNextVolumeMountPointA (winbase.h)
Continua una ricerca di cartelle montata avviata da una chiamata alla funzione FindFirstVolumeMountPoint. FindNextVolumeMountPoint trova una cartella montata per ogni chiamata.
Sintassi
BOOL FindNextVolumeMountPointA(
[in] HANDLE hFindVolumeMountPoint,
[out] LPSTR lpszVolumeMountPoint,
[in] DWORD cchBufferLength
);
Parametri
[in] hFindVolumeMountPoint
Handle di ricerca di cartelle montato restituito da una chiamata precedente alla funzione FindFirstVolumeMountPoint.
[out] lpszVolumeMountPoint
Puntatore a un buffer che riceve il nome della cartella montata trovata.
[in] cchBufferLength
Lunghezza del buffer che riceve il nome della cartella montata, 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 ottenere informazioni estese sull'errore, chiamare GetLastError. Se non è possibile trovare altre cartelle montate, la funzione GetLastError restituisce il codice di errore ERROR_NO_MORE_FILES. In tal caso, chiudere la ricerca con la funzione FindVolumeMountPointClose.
Osservazioni
Dopo aver stabilito l'handle di ricerca chiamando FindFirstVolumeMountPoint, è possibile usare la funzione FindNextVolumeMountPoint per cercare altre cartelle montate.
FindFirstVolumeMountPoint, FindNextVolumeMountPointe FindVolumeMountPointClose funzioni restituiscono percorsi alle cartelle montate per un volume specificato. Non restituiscono lettere di unità o percorsi GUID del volume. Per informazioni sull'enumerazione dei percorsi di GUID del volume
Non è consigliabile presupporre alcuna correlazione tra l'ordine delle cartelle montate restituite con queste funzioni e l'ordine delle cartelle montate restituite da altre funzioni o strumenti.
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) | No |
| Resilient File System (ReFS) | No |
SMB non supporta le funzioni di gestione dei volumi. CsvFS non supporta l'aggiunta di punti di montaggio in un volume CSV. ReFS non indicizza i punti di montaggio.
Nota
L'intestazione winbase.h definisce FindNextVolumeMountPoint come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
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 |
winbase.h (include Windows.h) |
| libreria |
Kernel32.lib |
| dll | Kernel32.dll |