Compartilhar via

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

Adiciona um LUN ao LUN de destino como um novo plex.

Sintaxe

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

Parâmetros

[in] lunId

O GUID do LUN 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 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
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
 Esse valor retornado sinaliza um problema de software ou comunicação dentro de um provedor que armazena em cache informações sobre a matriz. Use o método IVdsHwProvider::Reenumerate seguido pelo método IVdsHwProvider::Refresh para restaurar o cache.
VDS_E_OBJECT_DELETED
0x8004240BL
 O objeto LUN não está mais presente.
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
 O LUN está em um estado de falha e não consegue executar a operação solicitada.
VDS_E_ANOTHER_CALL_IN_PROGRESS
0x80042404L
 Outra operação está em andamento. Esta operação não pode continuar até que a operação ou as operações anteriores sejam concluídas.
VDS_E_OBJECT_NOT_FOUND
0x80042405L
 Isso pode ser retornado de qualquer método que usa uma constante VDS_OBJECT_ID . Indica que o identificador não se refere a um objeto existente.
VDS_E_INVALID_OPERATION
0x80042415L
 A operação não é válida. Como alternativa, o LUN de origem é menor que o LUN de destino. Se o LUN de origem for maior que o LUN de destino, o LUN de destino permanecerá do mesmo tamanho e a operação será bem-sucedida.

Comentários

Depois que o chamador adiciona o novo LUN como um plex, ele não fica mais visível como um LUN. Se o chamador
adiciona um LUN espelhado, o VDS inclui cada plex como um plex discreto. Todos os dados no LUN adicionado são perdidos.

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

IVdsHwProvider::Reenumerate

IVdsHwProvider::Refresh

IVdsLun