FindFirstVolumeA 函式 (winbase.h)

擷取電腦上的磁碟區名稱。 FindFirstVolume 可用來開始掃描計算機的磁碟區。

語法

HANDLE FindFirstVolumeA(
  [out] LPSTR lpszVolumeName,
  [in]  DWORD cchBufferLength
);

[out] lpszVolumeName

緩衝區的指標，接收以 Null 結束的字串，指定找到之第一個磁碟區的磁碟區 GUID 路徑。

[in] cchBufferLength

要接收 磁碟區 GUID 路徑的緩衝區長度，以 TCHAR 為單位。

如果函式成功，則傳回值是搜尋句柄，用於後續呼叫 FindNextVolume 和 FindVolumeClose 函式。

如果函式找不到任何磁碟區，則傳回值為 INVALID_HANDLE_VALUE 錯誤碼。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

FindFirstVolume 函式會開啟磁碟區搜尋句柄，並傳回計算機上找到的第一個磁碟區的相關信息。建立搜尋句柄之後，您可以使用 FindNextVolume 函式來搜尋其他磁碟區。不再需要搜尋句柄時，請使用 FindVolumeClose 函式加以關閉。

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

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

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

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