FindFirstVolumeMountPointA 函式 （winbase.h）

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

語法

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

參數

[in] lpszRootPathName

磁碟區 GUID 路徑，可供磁碟區掃描已掛接的資料夾。 需要尾端反斜杠。

[out] lpszVolumeMountPoint

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

[in] cchBufferLength

接收掛接資料夾路徑的緩衝區長度，TCHAR秒。

傳回值

如果函式成功，則傳回值是搜尋句柄，用於後續呼叫 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 標頭會根據 UNICODE 預處理器常數的定義，將 FindFirstVolumeMountPoint 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求	價值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
支援的最低伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平臺	窗戶
標頭	winbase.h （包括 Windows.h）
連結庫	Kernel32.lib
DLL	Kernel32.dll

另請參閱

FindNextVolumeMountPoint

FindVolumeMountPointClose

掛接的資料夾

磁碟區管理功能