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