FindVolumeClose 函式 (fileapi.h)

  • 發行項

關閉指定的磁碟區搜尋句柄。 FindFirstVolume 和 FindNextVolume 函式會使用此搜尋句柄來尋找磁碟區。

語法

BOOL FindVolumeClose(
  [in] HANDLE hFindVolume
);

參數

[in] hFindVolume

要關閉的磁碟區搜尋句柄。 此句柄先前必須由 FindFirstVolume 函式開啟。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

呼叫 FindVolumeClose 函式之後，句柄 hFindVolume 無法在 後續呼叫 FindNextVolume 或FindVolumeClose 時使用。

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

技術 支援
伺服器消息塊 (SMB) 3.0 通訊協定 No
SMB 3.0 透明故障轉移 (TFO) No
具有向外延展檔案共用的SMB 3.0 (SO) No
叢集共用磁碟區文件系統 (CsvFS) Yes
彈性檔案系統 (ReFS) Yes
 

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

範例

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

規格需求

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

另請參閱

FindFirstVolume

FindNextVolume

掛接的資料夾

磁碟區管理功能