FindNextVolumeA 函式 (winbase.h)

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

語法

BOOL FindNextVolumeA(
  [in]  HANDLE hFindVolume,
  [out] LPSTR  lpszVolumeName,
  [in]  DWORD  cchBufferLength
);

[in] hFindVolume

先前呼叫 FindFirstVolume 函式所傳回的磁碟區搜尋句柄。

[out] lpszVolumeName

字串的指標，可接收找到的磁碟區 GUID 路徑。

[in] cchBufferLength

在 TCHAR 中接收磁碟區 GUID 路徑的緩衝區長度。

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

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

藉由呼叫 FindFirstVolume 建立搜尋句柄之後，您可以使用 FindNextVolume 函式來搜尋其他磁碟區。

您不應該假設這些函式傳回的磁碟區順序與計算機上磁碟區的順序之間的任何相互關聯。特別是，如果有任何) 或磁碟管理員，請勿假設 (BIOS 指派的磁碟區順序與驅動器號之間的任何相互關聯。

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

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

如需範例，請參閱顯示磁碟區路徑。