FindNextVolumeMountPointA 函式 (winbase.h)

繼續呼叫 FindFirstVolumeMountPoint 函式所啟動的掛接資料夾搜尋。 FindNextVolumeMountPoint 會為每個呼叫尋找一個掛接的資料夾。

語法

BOOL FindNextVolumeMountPointA(
  [in]  HANDLE hFindVolumeMountPoint,
  [out] LPSTR  lpszVolumeMountPoint,
  [in]  DWORD  cchBufferLength
);

參數

[in] hFindVolumeMountPoint

先前呼叫 FindFirstVolumeMountPoint 函式所傳回的掛接資料夾搜尋句柄。

[out] lpszVolumeMountPoint

緩衝區的指標，接收所找到之掛接資料夾的名稱。

[in] cchBufferLength

在 TCHAR 中接收掛接資料夾名稱的緩衝區長度。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。 如果找不到更多掛接的資料夾， GetLastError 函式會傳回 ERROR_NO_MORE_FILES 錯誤碼。 在此情況下，請使用 FindVolumeMountPointClose 函式關閉搜尋。

備註

藉由呼叫 FindFirstVolumeMountPoint 建立搜尋句柄之後，您可以使用 FindNextVolumeMountPoint 函式來搜尋其他掛接的資料夾。

FindFirstVolumeMountPoint、FindNextVolumeMountPoint 和 FindVolumeMountPointClose 函式會傳回指定磁碟區之掛接資料夾的路徑。 它們不會傳回驅動器號或磁碟區 GUID 路徑。 如需列舉磁碟區 GUID 路徑的相關信息，請參閱 列舉磁碟區 GUID 路徑。

您不應該假設這些函式所傳回之掛接資料夾的順序，以及其他函式或工具所傳回之掛接資料夾的順序之間的任何相互關聯。

在 Windows 8 和 Windows Server 2012 中，下列技術支援此函式。

技術	支援
伺服器消息塊 (SMB) 3.0 通訊協定	No
SMB 3.0 透明故障轉移 (TFO)	No
具有向外延展檔案共用的SMB 3.0 (SO)	No
叢集共用磁碟區文件系統 (CsvFS)	No
彈性檔案系統 (ReFS)	No

 

SMB 不支援磁碟區管理功能。 CsvFS 不支援在 CSV 磁碟區上新增裝入點。 ReFS 不會為裝入點編製索引。

注意

winbase.h 標頭會將 FindNextVolumeMountPoint 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	winbase.h (包含 Windows.h)
程式庫	Kernel32.lib
DLL	Kernel32.dll

另請參閱

FindFirstVolumeMountPoint

FindVolumeMountPointClose

掛接的資料夾

磁碟區管理功能