IOCTL_VOLUME_OFFLINE IOCTL (winioctl.h)
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) |