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 不支援磁片區管理功能。

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