Compartilhar via


Método IVdsVolumeMF3::OfflineVolume (vds.h)

[Começando com Windows 8 e Windows Server 2012, a interface COM do Serviço de Disco Virtual é substituída pela API de Gerenciamento de Armazenamento do Windows.]

Coloca o volume offline usando o código de controle IOCTL_VOLUME_OFFLINE .

Sintaxe

HRESULT OfflineVolume();

Retornar valor

Esse método pode retornar valores HRESULT padrão, como E_INVALIDARG ou E_OUTOFMEMORY e valores retornados específicos do VDS. Ele também pode retornar códigos de erro do sistema convertidos usando a macro HRESULT_FROM_WIN32 . Os erros podem ser originados do próprio VDS ou do provedor de VDS subjacente que está sendo usado. Os possíveis valores retornados incluem o seguinte.

Código de retorno Descrição
S_OK
O método foi concluído com sucesso.

Comentários

Se o volume já estiver offline, o método OfflineVolume retornará S_OK.

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 desmontar um volume, use o método IVdsVolumeMF::D ismount .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho vds.h
Biblioteca Uuid.lib

Confira também

IVdsVolumeMF3