Bagikan melalui

IOCTL_VOLUME_OFFLINE IOCTL (winioctl.h)

  • Artikel

Mengambil volume offline.

Windows Server 2003 dan Windows XP: Kode kontrol ini tidak didukung untuk disk dinamis.

Untuk melakukan operasi ini, panggil fungsi DeviceIoControl dengan parameter berikut.

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
);

Keterangan

Aplikasi harus terlebih dahulu berhasil melepas sistem file - melalui FSCTL_DISMOUNT_VOLUME - sebelum menggunakan IOCTL_VOLUME_OFFLINE.

Ketika volume yang online dilepas, panggilan berikutnya untuk membuka volume menyebabkan volume dipasang. Mengambil volume offline menggunakan handel volume yang sama seperti yang digunakan untuk melepas mencegah volume yang dilepas dipasang lagi.

Ketika volume online, semua permintaan yang dikirim ke volume akan dihormati.

Ketika volume yang online dilepas, panggilan berikutnya untuk membuka volume menyebabkan volume dipasang. Mengambil volume offline mencegah volume yang dilepas dipasang lagi.

Untuk membuat volume online, gunakan kode kontrol IOCTL_VOLUME_ONLINE .

Di Windows 8 dan Windows Server 2012, kode ini didukung oleh teknologi berikut.

Teknologi Didukung
Protokol Server Message Block (SMB) 3.0 Tidak
SMB 3.0 Transparent Failover (TFO) Tidak
SMB 3.0 dengan Scale-out File Shares (SO) Tidak
Sistem File Volume Bersama Kluster (CsvFS) Tidak

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Header winioctl.h (termasuk Windows.h)

Lihat juga