Funzione FindNextVolumeMountPointA (winbase.h)

  • Articolo

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 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 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 .

Commenti

Dopo aver stabilito l'handle di ricerca chiamando FindFirstVolumeMountPoint, è possibile utilizzare la funzione FindNextVolumeMountPoint per cercare altre cartelle montate.

Le funzioni FindFirstVolumeMountPoint, FindNextVolumeMountPoint e FindVolumeMountPointClose 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 GUID del volume per un volume, vedere Enumerazione dei percorsi 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 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) No
Resilient File System (ReFS) No
 

SMB non supporta le funzioni di gestione dei volumi. CsvFS non supporta l'aggiunta di un punto 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

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 winbase.h (include Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

FindFirstVolumeMountPoint

FindVolumeMountPointClose

Cartelle montate

Funzioni di gestione dei volumi