Compartilhar via


Método IVdsDiskOnline::Offline (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 disco offline. Windows Vista: Esse método não tem suporte até o Windows Vista com o Service Pack 1 (SP1). Em vez disso, use IVdsDisk2::SetSANMode .

Sintaxe

HRESULT Offline();

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 se originar 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
VDS_E_FAILED_TO_OFFLINE_DISK
Falha na operação offline.

Comentários

Se um disco dinâmico for de leitura/gravação e online, ele poderá ser feito somente leitura e colocado offline da seguinte maneira:

  1. Para cada volume no disco, chame o método IVdsVolumeMF::D ismount , definindo os parâmetros bForce e bPermanent como TRUE.
  2. Chame o método Offline .
  3. Defina o bit somente leitura. (Este é o sinalizador VDS_DF_READ_ONLY na estrutura VDS_DISK_PROP .)
Se um disco básico for de leitura/gravação e online, ele poderá ser feito somente leitura e colocado offline da mesma maneira, mas a ordem das etapas não importa.

Requisitos

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

Confira também

IVdsDiskOnline

IVdsDiskOnline::Online