Compartilhar via

IOCTL_VOLUME_ONLINE IOCTL (winioctl.h)

  • Artigo

Coloca um volume online.

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

Comentários

Quando um volume está offline, todas as solicitações de leitura, gravação e IOCTL falham com ERROR_NOT_READY. Não é possível deixar o sistema ou o volume de inicialização offline.

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 offline, use o código de controle IOCTL_VOLUME_OFFLINE .

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