Método IVdsLun::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 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 |
|---|---|
|
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. |
|
O objeto LUN não está mais presente. |
|
O LUN está em um estado de falha e não consegue executar a operação solicitada. |
|
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. |
|
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. |
|
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 |