Compartilhar via


Método IVdsDisk2::SetSANMode (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.]

Define o modo SAN de um disco como offline ou online.

Nota A partir do Windows Vista com o Service Pack 1 (SP1), esse método é substituído pelos métodos IVdsDiskOnline::Online e IVdsDiskOnline::Offline .

 

Sintaxe

HRESULT SetSANMode(
  [in] BOOL bEnable
);

Parâmetros

[in] bEnable

Especifique TRUE para online ou FALSE para 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.

Valor/código retornado Descrição
S_OK
O modo SAN foi definido com êxito.
VDS_E_FAILED_TO_OFFLINE_DISK
0x80042597L
Falha na operação offline.
VDS_E_FAILED_TO_ONLINE_DISK
0x80042596L
Falha na operação online.

Comentários

Definir o modo SAN de um disco como offline é chamado de "offlining" do disco. Defini-lo como online é chamado de "onlining" do disco.

Windows Vista: Definir o modo SAN de um disco como offline também torna o disco somente leitura. Defini-lo como online também torna o disco leitura-gravação.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [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

IVdsDisk2