FindNextVolumeW 函式 (fileapi.h)

繼續呼叫 FindFirstVolume 函式所啟動的磁片區搜尋。 FindNextVolume 會為每個呼叫尋找一個磁片區。

語法

BOOL FindNextVolumeW(
  [in]  HANDLE hFindVolume,
  [out] LPWSTR lpszVolumeName,
  [in]  DWORD  cchBufferLength
);

參數

[in] hFindVolume

前一次呼叫 FindFirstVolume 函式所傳回的磁片區搜尋控制碼。

[out] lpszVolumeName

字串的指標,接收找到的磁片區 GUID 路徑。

[in] cchBufferLength

接收 磁片區 GUID 路徑的緩衝區長度,以 TCHAR為單位。

傳回值

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

如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。 如果找不到相符的檔案, GetLastError 函式會傳回 ERROR_NO_MORE_FILES 錯誤碼。 在此情況下,請使用 FindVolumeClose 函式關閉搜尋。

備註

藉由呼叫 FindFirstVolume建立搜尋控制碼之後,您可以使用 FindNextVolume 函式來搜尋其他磁片區。

您不應該假設這些函式所傳回的磁片區順序與電腦上磁片區的順序之間的任何相互關聯。 特別是,如果有任何) 或磁片系統管理員,請勿假設 BIOS (指派的磁片區順序與磁碟機號之間的任何相互關聯。

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

技術 支援
伺服器訊息區 (SMB) 3.0 通訊協定
SMB 3.0 透明容錯移轉 (TFO)
具有向外延展檔案共用的 SMB 3.0 (SO)
叢集共用磁片區檔案系統 (CsvFS)
彈性檔案系統 (ReFS)
 

SMB 不支援磁片區管理功能。

範例

如需範例,請參閱 顯示磁片區路徑

需求

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

另請參閱

FindFirstVolume

FindVolumeClose

掛接的資料夾

磁片區管理功能