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)

另請參閱