FindFirstVolumeW 函式 (fileapi.h)

擷取電腦上的磁片區名稱。 FindFirstVolume 可用來開始掃描電腦的磁片區。

語法

HANDLE FindFirstVolumeW(
  [out] LPWSTR 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 不支援磁片區管理功能。

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