Funzione FindFirstVolumeMountPointW (winbase.h)
Recupera il nome di una cartella montata nel volume specificato. FindFirstVolumeMountPoint viene usato per iniziare a analizzare le cartelle montate in un volume.
Sintassi
HANDLE FindFirstVolumeMountPointW(
[in] LPCWSTR lpszRootPathName,
[out] LPWSTR lpszVolumeMountPoint,
[in] DWORD cchBufferLength
);
Parametri
[in] lpszRootPathName
Percorso GUID del volume per il volume da analizzare per le cartelle montate. È necessaria una barra rovesciata finale.
[out] lpszVolumeMountPoint
Puntatore a un buffer che riceve il nome della prima cartella montata trovata.
[in] cchBufferLength
Lunghezza del buffer che riceve il percorso della cartella montata, in TCHARs.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è un handle di ricerca utilizzato in una chiamata successiva alle funzioni FindNextVolumeMountPoint e FindVolumeMountPointClose .
Se la funzione non riesce a trovare una cartella montata nel volume, il valore restituito è il codice di errore INVALID_HANDLE_VALUE . Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
La funzione FindFirstVolumeMountPoint apre un handle di ricerca di cartelle montata e restituisce informazioni sulla prima cartella montata presente nel volume specificato. Dopo aver stabilito l'handle di ricerca, è possibile utilizzare la funzione FindNextVolumeMountPoint per cercare altre cartelle montate. Quando l'handle di ricerca non è più necessario, chiuderlo con la funzione FindVolumeMountPointClose .
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 da 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 FindFirstVolumeMountPoint 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 |