Método IVdsPack::ReplaceDisk (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.]

No compatible.

Este método está reservado para un uso futuro.

Sintaxis

HRESULT ReplaceDisk(
  [in]  VDS_OBJECT_ID OldDiskId,
  [in]  VDS_OBJECT_ID NewDiskId,
  [out] IVdsAsync     **ppAsync
);

Parámetros

[in] OldDiskId

GUID del disco antiguo.

[in] NewDiskId

GUID del nuevo disco.

[out] ppAsync

Dirección de un puntero de interfaz IVdsAsync , que VDS inicializa al devolver. Los autores de llamadas deben liberar la interfaz. Use esta interfaz 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 se pueden originar en VDS en sí o en el proveedor de VDS subyacente que se está usando. Entre los posibles valores devueltos se incluyen los siguientes.

Código o valor devuelto	Descripción
S_OK	El reemplazo del disco se completó correctamente.
VDS_E_NOT_SUPPORTED 0x80042400L	Este método no se admite en esta versión.

Comentarios

Los autores de llamadas pueden usar este método para la migración de medios (reemplazando un disco antiguo por un disco nuevo) o al reparar un conjunto tolerante a errores con un miembro que falta o con errores, especialmente para aquellos proveedores que no implementan moderación activa.

El nuevo disco debe estar en el mismo paquete que el disco antiguo y no puede contener datos; puede tener un estilo de partición incorrecto. En caso de un reemplazo correcto, el disco antiguo conserva el estilo de creación de particiones, pero no hay volúmenes válidos.

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. Si el proveedor no implementa la moderación activa, debe admitir el escenario de miembro con error: inicie la sincronización del volumen expuesto con tolerancia a errores de nuevo después de que el autor de la llamada invoque el método ReplaceDisk .

Requisitos

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