IOCTL_VOLUME_ONLINE IOCTL (winioctl.h)

  • Articolo

Porta online un volume.

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_ONLINE,          // dwIoControlCode
  NULL,                         // lpInBuffer
  0,                            // nInBufferSize
  NULL,                         // lpOutBuffer
  0,                            // nOutBufferSize
  (LPDWORD) lpBytesReturned,    // number of bytes returned
  (LPOVERLAPPED) lpOverlapped   // OVERLAPPED structure
);

Commenti

Quando un volume è offline, tutte le richieste di lettura, scrittura e IOCTL hanno esito negativo con ERROR_NOT_READY. Non è possibile portare offline il volume di sistema o di avvio.

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

Quando un volume online viene smontato, la chiamata successiva per aprire il volume ne determina il montaggio. L'utilizzo offline del volume impedisce il montaggio del volume smontato.

Per portare offline un volume, usare il codice di controllo IOCTL_VOLUME_OFFLINE .

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 di scalabilità orizzontale (SO) No
File system del volume condiviso 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