IOCTL_VOLUME_ONLINE IOCTL (winioctl.h)

  • Artículo

Pone un volumen en línea.

Windows Server 2003 y Windows XP: Este código de control no se admite para discos dinámicos.

Para realizar esta operación, llame a la función DeviceIoControl con los siguientes parámetros.

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

Comentarios

Cuando un volumen está sin conexión, todas las solicitudes de lectura, escritura e IOCTL producen un error ERROR_NOT_READY. No se puede desconectar el sistema o el volumen de arranque.

Cuando un volumen está en línea, se respetan todas las solicitudes enviadas al volumen.

Cuando se desmonta un volumen que está en línea, la siguiente llamada para abrir el volumen hace que se monte. Desconectar el volumen impide que el volumen desmontado se vuelva a montar.

Para desconectar un volumen, use el código de control IOCTL_VOLUME_OFFLINE .

En Windows 8 y Windows Server 2012, este código es compatible con las siguientes tecnologías.

Tecnología Compatible
Protocolo Bloque de mensajes del servidor (SMB) 3.0 No
Conmutación por error transparente (TFO) de SMB 3.0 No
SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO) No
Sistema de archivos de Volumen compartido de clúster (CsvFS) No

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado winioctl.h (incluye Windows.h)

Consulte también