Compartilhar via

IOCTL_VOLUME_OFFLINE IOCTL (winioctl.h)

  • Artigo

Coloca um volume offline.

Windows Server 2003 e Windows XP: Não há suporte para esse código de controle para discos dinâmicos.

Para executar essa operação, chame a função DeviceIoControl com os parâmetros a seguir.

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

Comentários

Os aplicativos devem primeiro desmontar com êxito o sistema de arquivos - por meio de FSCTL_DISMOUNT_VOLUME - antes de usar IOCTL_VOLUME_OFFLINE.

Quando um volume online é desmontado, a próxima chamada para abrir o volume faz com que ele seja montado. Colocar o volume offline usando o mesmo identificador de volume usado para a desmontagem impede que o volume desmontado seja montado novamente.

Quando um volume está online, todas as solicitações enviadas ao volume são respeitadas.

Quando um volume online é desmontado, a próxima chamada para abrir o volume faz com que ele seja montado. Colocar o volume offline impede que o volume desmontado seja montado novamente.

Para colocar um volume online, use o código de controle IOCTL_VOLUME_ONLINE .

Em Windows 8 e Windows Server 2012, esse código é compatível com as tecnologias a seguir.

Tecnologia Com suporte
Protocolo SMB (SMB) 3.0 No
TFO (Failover transparente) do SMB 3.0 No
SMB 3.0 com compartilhamentos de arquivos de expansão (SO) No
Sistema de arquivos de Volume Compartilhado Clusterizado (CsvFS) No

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho winioctl.h (inclua Windows.h)

Confira também