Compartilhar via


Método IVdsVolume::AddPlex (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.]

Adiciona um volume como um plex ao volume atual.

Sintaxe

HRESULT AddPlex(
  [in]  VDS_OBJECT_ID VolumeId,
  [out] IVdsAsync     **ppAsync
);

Parâmetros

[in] VolumeId

O GUID do volume a ser adicionado como um plex.

[out] ppAsync

O endereço de um ponteiro de interface IVdsAsync , que o VDS inicializa no retorno. Os chamadores devem liberar a interface. Use esse ponteiro 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 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 plex foi adicionado com êxito.
VDS_S_GPT_BOOT_MIRRORED_TO_MBR
0x80042469L
O volume de inicialização em um disco GPT foi espelhado para um disco MBR. O novo plex não pode ser usado para inicializar o computador.
VDS_E_VOLUME_NOT_ONLINE
0x8004243DL
O volume não está acessível.
VDS_E_VOLUME_NOT_HEALTHY
0x8004243EL
O volume está falhando ou falhou.
VDS_E_VOLUME_SPANS_DISKS
0x8004243FL
O volume abrange vários discos.
VDS_E_REQUIRES_CONTIGUOUS_DISK_SPACE
0x80042440L
O volume consiste em várias extensões.
VDS_E_INVALID_OPERATION
0x80042415L
O volume de origem é menor que o volume de destino. Se o volume de origem for maior que o volume de destino, o volume de destino permanecerá do mesmo tamanho e a operação terá êxito.

Comentários

Essa operação não é válida para volumes básicos, que têm exatamente um plex.

Use esse método para adicionar um volume como um plex a outro volume. Por exemplo, um chamador pode criar um volume (volume B), especificar o volume B como um novo plex para um volume existente (volume A) e remover o volume B. O novo plex do Volume A ocupa as mesmas extensões de disco que o volume B.

Nota O VDS tenta usar as mesmas extensões, mas não pode garantir esse comportamento.
 
Os chamadores podem adicionar um volume espelhado como um novo plex a outro volume. O volume resultante contém plexes iguais em número à soma dos volumes originais.

Os implementadores devem retornar um ponteiro para a interface IVdsAsync para esse método, independentemente de a chamada iniciar uma operação assíncrona.

Requisitos

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

Confira também

IVdsAsync

IVdsVolume

Objeto Plex de Volume