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

Remove um ou mais plexes especificados do volume atual, liberando as extensões.

Sintaxe

HRESULT RemovePlex(
  [in]  VDS_OBJECT_ID plexId,
  [out] IVdsAsync     **ppAsync
);

Parâmetros

[in] plexId

O GUID do plex a ser removido.

[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 ser originados do próprio VDS ou do provedor de VDS subjacente que está sendo usado. Os possíveis valores retornados incluem o seguinte.

Comentários

Esta operação não pode remover o último plex de um volume. Em vez disso, use o método IVdsVolume::D elete para remover o último volume restante (o único plex). Esse método não é válido para volumes básicos, que têm exatamente um plex.

O VDS não desmonta o volume quando remove um plex.

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

Confira também

IVdsAsync

IVdsVolume

IVdsVolume::D elete