FindFirstVolumeMountPointA 函式 (winbase.h)

  • 發行項

擷取指定磁片區上掛接資料夾的名稱。 FindFirstVolumeMountPoint 可用來開始掃描磁片區上掛接的資料夾。

語法

HANDLE FindFirstVolumeMountPointA(
  [in]  LPCSTR lpszRootPathName,
  [out] LPSTR  lpszVolumeMountPoint,
  [in]  DWORD  cchBufferLength
);

參數

[in] lpszRootPathName

要掃描已掛接資料夾之磁片區的磁片區 GUID 路徑。 需要尾端反斜線。

[out] lpszVolumeMountPoint

緩衝區的指標，接收找到之第一個掛接資料夾的名稱。

[in] cchBufferLength

在 TCHARs 中接收掛接資料夾路徑的緩衝區長度。

傳回值

如果函式成功，則傳回值是搜尋控制碼，用於 後續呼叫 FindNextVolumeMountPoint 和 FindVolumeMountPointClose 函式。

如果函式在磁片區上找不到掛接的資料夾，則傳回值為 INVALID_HANDLE_VALUE 錯誤碼。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

FindFirstVolumeMountPoint函式會開啟掛接的資料夾搜尋控制碼，並傳回指定磁片區上找到之第一個掛接資料夾的相關資訊。 建立搜尋控制碼之後，您可以使用 FindNextVolumeMountPoint 函式來搜尋其他掛接的資料夾。 不再需要搜尋控制碼時，請使用 FindVolumeMountPointClose 函式加以關閉。

FindFirstVolumeMountPoint、FindNextVolumeMountPoint和FindVolumeMountPointClose函式會傳回指定磁片區之掛接資料夾的路徑。 它們不會傳回磁碟機號或磁片區 GUID 路徑。 如需列舉磁片區 GUID 路徑的相關資訊，請參閱 列舉磁片區 GUID 路徑。

您不應該假設這些函式所傳回之掛接資料夾的順序，以及其他函式或工具所傳回之掛接資料夾的順序之間的任何相互關聯。

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

技術 支援
伺服器訊息區 (SMB) 3.0 通訊協定 否
SMB 3.0 透明容錯移轉 (TFO) 否
具有向外延展檔案共用的 SMB 3.0 (SO) 否
叢集共用磁片區檔案系統 (CsvFS) 否
彈性檔案系統 (ReFS) 否
 

SMB 不支援磁片區管理功能。 CsvFS 不支援在 CSV 磁片區上新增掛接點。 ReFS 不會為掛接點編制索引。

注意

winbase.h 標頭會將 FindFirstVolumeMountPoint 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

   
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 winbase.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

FindNextVolumeMountPoint

FindVolumeMountPointClose

掛接的資料夾

磁片區管理功能