Funzione FindFirstVolumeMountPointA (winbase.h)

  • Articolo

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 FindFirstVolumeMountPointA(
  [in]  LPCSTR lpszRootPathName,
  [out] LPSTR  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

   
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

FindNextVolumeMountPoint

FindVolumeMountPointClose

Cartelle montate

Funzioni di gestione dei volumi