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

  • Artículo

[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.]

Agrega un volumen como un plex al volumen actual.

Sintaxis

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

Parámetros

[in] VolumeId

GUID del volumen que se va a agregar como un plex.

[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 agregó correctamente.
VDS_S_GPT_BOOT_MIRRORED_TO_MBR
0x80042469L
 El volumen de arranque de un disco GPT se ha reflejado en un disco MBR. No se puede usar el nuevo plex para arrancar el equipo.
VDS_E_VOLUME_NOT_ONLINE
0x8004243DL
 No se puede acceder al volumen.
VDS_E_VOLUME_NOT_HEALTHY
0x8004243EL
 Se produce un error en el volumen o se ha producido un error.
VDS_E_VOLUME_SPANS_DISKS
0x8004243FL
 El volumen abarca varios discos.
VDS_E_REQUIRES_CONTIGUOUS_DISK_SPACE
0x80042440L
 El volumen consta de varias extensiones.
VDS_E_INVALID_OPERATION
0x80042415L
 El volumen de origen es menor que el volumen de destino. Si el volumen de origen es mayor que el volumen de destino, el volumen de destino sigue siendo el mismo tamaño y la operación se realiza correctamente.

Comentarios

Esta operación no es válida para volúmenes básicos, que tienen exactamente un plex.

Use este método para agregar un volumen como un plex a otro volumen. Por ejemplo, un autor de la llamada puede crear un volumen (volumen B), especificar el volumen B como un nuevo plex para un volumen existente (volumen A) y, a continuación, quitar el volumen B. El nuevo plex del volumen A ocupa las mismas extensiones de disco que el volumen B.

Nota VDS intenta usar las mismas extensiones, pero no puede garantizar este comportamiento.
 
Los autores de llamadas pueden agregar un volumen reflejado como un nuevo plex a otro volumen. El volumen resultante contiene plexos iguales en número a la suma de los volúmenes originales.

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

Volume Plex (objeto)