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) 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

另請參閱

FindNextVolume

FindVolumeClose

掛接的資料夾

磁片區管理功能