Compartilhar via

Método IVdsPack::ReplaceDisk (vds.h)

  • Artigo

[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.]

Não há suporte.

Este método está reservado para uso futuro.

Sintaxe

HRESULT ReplaceDisk(
  [in]  VDS_OBJECT_ID OldDiskId,
  [in]  VDS_OBJECT_ID NewDiskId,
  [out] IVdsAsync     **ppAsync
);

Parâmetros

[in] OldDiskId

O GUID do disco antigo.

[in] NewDiskId

O GUID do novo disco.

[out] ppAsync

O endereço de um ponteiro de interface IVdsAsync , que o VDS inicializa no retorno. Os chamadores devem liberar a interface . Use essa interface para cancelar, aguardar ou consultar o status da operação.

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.

Valor/código retornado Descrição
S_OK
 A substituição de disco foi concluída com êxito.
VDS_E_NOT_SUPPORTED
0x80042400L
 Não há suporte para esse método nesta versão.

Comentários

Os chamadores podem usar esse método para migração de mídia (substituindo um disco antigo por um novo disco) ou ao reparar um conjunto tolerante a falhas com um membro ausente ou com falha, especialmente para os provedores que não implementam a moderação dinâmica.

O novo disco deve estar no mesmo pacote que o disco antigo e não pode conter dados; ele pode ter o estilo de particionamento errado. No caso de uma substituição bem-sucedida, o disco antigo mantém o estilo de particionamento, mas nenhum volume válido.

Os implementadores devem retornar um ponteiro para a interface IVdsAsync para esse método, independentemente de a chamada iniciar uma operação assíncrona. Se o provedor não implementar a moderação frequente, ele deverá dar suporte ao cenário de membro com falha: comece a sincronizar o volume tolerante a falhas exposto novamente depois que o chamador invocar o método ReplaceDisk .

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