IOCTL_VOLUME_OFFLINE IOCTL (winioctl.h)

  • Articolo

Accetta un volume offline.

Windows Server 2003 e Windows XP: Questo codice di controllo non è supportato per i dischi dinamici.

Per eseguire questa operazione, chiamare la funzione DeviceIoControl con i parametri seguenti.

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

Commenti

Le applicazioni devono prima smontare correttamente il file system, tramite FSCTL_DISMOUNT_VOLUME , prima di usare IOCTL_VOLUME_OFFLINE.

Quando un volume online è smontato, la chiamata successiva per aprire il volume causa il montaggio. Se si usa lo stesso handle del volume usato per la smontaggio, il volume smontato impedisce di montare di nuovo il volume smontato.

Quando un volume è online, tutte le richieste inviate al volume vengono rispettate.

Quando un volume online è smontato, la chiamata successiva per aprire il volume causa il montaggio. L'uso offline del volume impedisce il montaggio del volume smontato.

Per portare un volume online, usare il codice di controllo IOCTL_VOLUME_ONLINE .

In Windows 8 e Windows Server 2012 questo codice è supportato dalle tecnologie seguenti.

Tecnologia Supportato
Protocollo SMB (Server Message Block) 3.0 No
Failover trasparente SMB 3.0 (TFO) No
SMB 3.0 con condivisioni file con scalabilità orizzontale (SO) No
File system del volume condiviso del cluster (CsvFS) No

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione winioctl.h (include Windows.h)

Vedi anche