Compartir a través de


Método IVdsVolume::RemovePlex (vds.h)

[A partir de Windows 8 y Windows Server 2012, la interfaz COM del servicio de disco virtual se sustituye por la API de administración de almacenamiento de Windows.]

Quita uno o varios plexos especificados del volumen actual, liberando las extensiones.

Sintaxis

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

Parámetros

[in] plexId

GUID del plex que se va a quitar.

[out] ppAsync

Dirección de un puntero de interfaz IVdsAsync , que VDS inicializa al devolver. Los autores de llamadas deben liberar la interfaz . Use este puntero para cancelar, esperar o consultar el estado de la operación.

Valor devuelto

Este método puede devolver valores HRESULT estándar, como E_INVALIDARG o E_OUTOFMEMORY, y valores devueltos específicos de VDS. También puede devolver códigos de error del sistema convertidos mediante la macro HRESULT_FROM_WIN32 . Los errores pueden originarse en VDS en sí o en el proveedor de VDS subyacente que se está usando. Entre los valores devueltos posibles se incluyen los siguientes.

Código o valor devuelto Descripción
S_OK
El plex se quitó correctamente.
VDS_E_VOLUME_NOT_ONLINE
0x8004243DL
No se puede acceder al volumen.
VDS_E_VOLUME_NOT_A_MIRROR
0x80042445L
El volumen no es un reflejo.

Comentarios

Esta operación no puede quitar el último plex de un volumen. En su lugar, use el método IVdsVolume::D elete para quitar el último volumen restante (el único plex). Este método no es válido para volúmenes básicos, que tienen exactamente un plex.

VDS no desmonta el volumen cuando quita un plex.

Los implementadores deben devolver un puntero a la interfaz IVdsAsync de este método, independientemente de si la llamada inicia una operación asincrónica.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado vds.h
Library Uuid.lib

Consulte también

IVdsAsync

IVdsVolume

IVdsVolume::D elete