IOCTL_VOLUME_OFFLINE IOCTL (winioctl.h)

  • Artículo

Desconecta un volumen.

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

Comentarios

Primero, las aplicaciones deben desmontar correctamente el sistema de archivos ( a través de FSCTL_DISMOUNT_VOLUME ) antes de usar IOCTL_VOLUME_OFFLINE.

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

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 poner un volumen en línea, use el código de control IOCTL_VOLUME_ONLINE .

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