GetVolumeNameForVolumeMountPointW
GetVolumeNameForVolumeMountPoint is a Windows API function used to obtain the unique volume name, or volume GUID path, for a specified mount point. The returned name identifies the target volume independently of drive letters, which helps maintain consistent references when volumes are relettered or mounted at different points.
There are two API variants: GetVolumeNameForVolumeMountPointW (Unicode) and GetVolumeNameForVolumeMountPointA (ANSI). The Unicode version is generally preferred
- lpszVolumeMountPoint: A pointer to a string that specifies the path to a mount point or the root
- lpszVolumeName: A pointer to a buffer that receives the resulting volume name in the form of a
- cchBufferLength: The size of the output buffer, in TCHARs.
- Nonzero indicates success. The function writes the volume GUID path into lpszVolumeName.
- Zero indicates failure. Call GetLastError for details. If the buffer is too small, the function returns
- The function is useful in volume enumeration, mounting operations, and storage management tasks where a stable
- The output is a GUID-based path and can be used with other volume-related APIs that operate
- Requires appropriate permissions to query the volume information; behavior may vary for remote or removable storage.
- GetVolumePathName, to obtain a volume path from a GUID name
- Get.Volumes or other volume management APIs in Kernel32
This article provides a concise overview of the function and its typical usage in Windows programming.