Funzione GetVolumeNameForVolumeMountPointA (winbase.h)

Recupera un percorso GUID del volume per il volume associato al punto di montaggio del volume specificato ( lettera di unità, percorso GUID del volume o cartella montata).

Sintassi

BOOL GetVolumeNameForVolumeMountPointA(
  [in]  LPCSTR lpszVolumeMountPoint,
  [out] LPSTR  lpszVolumeName,
  [in]  DWORD  cchBufferLength
);

Parametri

[in] lpszVolumeMountPoint

Puntatore a una stringa che contiene il percorso di una cartella montata (ad esempio, "Y:\MountX") o una lettera di unità (ad esempio, "X:\"). La stringa deve terminare con una barra rovesciata finale ('').

[out] lpszVolumeName

Puntatore a una stringa che riceve il percorso GUID del volume. Questo percorso è nel formato "\?\Volume{GUID}" dove GUID è un GUID che identifica il volume. Se è presente più di un percorso GUID del volume per il volume, viene restituito solo il primo percorso nella cache del gestore di montaggio.

[in] cchBufferLength

Lunghezza del buffer di output, in TCHAR. Una dimensione ragionevole per il buffer per contenere il percorso GUID del volume più grande possibile è di 50 caratteri.

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.

Commenti

Usare GetVolumeNameForVolumeMountPoint per ottenere un percorso GUID del volume da usare con funzioni quali SetVolumeMountPoint e FindFirstVolumeMountPoint che richiedono un percorso GUID del volume come parametro di input. Per altre informazioni sui percorsi GUID del volume, vedere Denominazione di un volume.

In Windows 8 e Windows Server 2012 questa funzione è supportata dalle tecnologie seguenti.

SMB non supporta le funzioni di gestione dei volumi.

I punti di montaggio non sono supportati dai volumi ReFS.

Requisiti

Vedere anche

DeleteVolumeMountPoint

GetVolumePathName

Cartelle montate

SetVolumeMountPoint

Funzioni di gestione dei volumi