Funzione FindFirstVolumeMountPointA (winbase.h)

Articolo
11/20/2024

Recupera il nome di una cartella montata nel volume specificato. findFirstVolumeMountPoint viene usato per avviare l'analisi delle 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 usato 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 ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

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 usare la funzione FindNextVolumeMountPoint per cercare altre cartelle montate. Quando l'handle di ricerca non è più necessario, chiuderlo con la funzione FindVolumeMountPointClose.

FindFirstVolumeMountPoint, FindNextVolumeMountPointe FindVolumeMountPointClose funzioni restituiscono percorsi alle cartelle montate per un volume specificato. Non restituiscono lettere di unità o volumi percorsi GUID. Per informazioni sull'enumerazione dei percorsi di 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	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 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 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

Vedere anche

FindNextVolumeMountPoint

FindVolumeMountPointClose

cartelle montate

funzioni di gestione dei volumi

Condividi tramite