FindNextVolumeMountPoint

The FindNextVolumeMountPoint function continues a volume mount point search started by a call to the FindFirstVolumeMountPoint function. FindNextVolumeMountPoint finds one volume mount point per call.

BOOL FindNextVolumeMountPoint(
  HANDLE hFindVolumeMountPoint,    // search handle
  LPTSTR lpszVolumeMountPoint,     // output buffer
  DWORD cchBufferLength            // size of output buffer
);

Parameters

hFindVolumeMountPoint

[in] Mount-point search handle returned by a previous call to the FindFirstVolumeMountPoint function.

lpszVolumeMountPoint

[out] Pointer to a string that receives the name of the volume mount point found.

cchBufferLength

[in] Specifies the length, in TCHARs, of the buffer that receives the names.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError. If no matching files can be found, the GetLastError function returns the ERROR_NO_MORE_FILES error code. In that case, close the search with the FindVolumeMountPointClose function.

Remarks

After the search handle is established by calling FindFirstVolumeMountPoint, you can use the FindNextVolumeMountPoint function to search for other volume mount points.

You should not assume any correlation between the order of volume mount points returned with these functions and the order of volume mount points returned by other tools.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Header: Declared in Winbase.h; include Windows.h.
  Library: Use Kernel32.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows 2000.

See Also

File Systems Overview, File System Functions, FindFirstVolumeMountPoint, FindVolumeMountPointClose