IOCTL_VOLUME_OFFLINE IOCTL (winioctl.h)
讓磁碟區脫機。
Windows Server 2003 和 Windows XP: 動態磁碟不支援此控制程序代碼。
若要執行這項作業,請使用下列參數呼叫 DeviceIoControl 函 式。
BOOL DeviceIoControl(
(HANDLE) hDevice, // handle to device
IOCTL_VOLUME_OFFLINE, // dwIoControlCode
NULL, // lpInBuffer
0, // nInBufferSize
NULL, // lpOutBuffer
0, // nOutBufferSize
(LPDWORD) lpBytesReturned, // number of bytes returned
(LPOVERLAPPED) lpOverlapped // OVERLAPPED structure
);
備註
應用程式必須先透過 FSCTL_DISMOUNT_VOLUME 成功卸除文件系統,才能使用 IOCTL_VOLUME_OFFLINE。
當卸除在線的磁碟區時,下一次開啟磁碟區呼叫會導致掛接磁碟區。 使用與卸除所使用的相同磁碟區句柄讓磁碟區脫機,可防止卸除的磁碟區再次掛接。
當磁碟區上線時,會接受傳送至磁碟區的所有要求。
當卸除在線的磁碟區時,下一次開啟磁碟區呼叫會導致掛接磁碟區。 讓磁碟區脫機,可防止卸除的磁碟區再次掛接。
若要讓磁碟區上線,請使用 IOCTL_VOLUME_ONLINE 控件程序代碼。
在 Windows 8 和 Windows Server 2012 中,下列技術支援此程序代碼。
技術 | 支援 |
---|---|
伺服器消息塊 (SMB) 3.0 通訊協定 | No |
SMB 3.0 透明故障轉移 (TFO) | No |
具有向外延展檔案共用的SMB 3.0 (SO) | No |
叢集共用磁碟區文件系統 (CsvFS) | No |
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
標頭 | winioctl.h (包含 Windows.h) |