Compartir a través de

Método IVdsOpenVDisk::Merge (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.]

Combina un disco virtual secundario con sus elementos primarios en la cadena de diferenciación.

Sintaxis

HRESULT Merge(
  [in]  MERGE_VIRTUAL_DISK_FLAG Flags,
  [in]  ULONG                   MergeDepth,
  [out] IVdsAsync               **ppAsync
);

Parámetros

[in] Flags

Valor de enumeración MERGE_VIRTUAL_DISK_FLAG que especifica cómo se va a combinar el disco virtual. Debe establecerse en MERGE_VIRTUAL_DISK_FLAG_NONE.

[in] MergeDepth

Número de discos primarios de la cadena de diferenciación que se va a combinar. El disco debe haberse abierto con readWriteDepth al menos igual a este valor.

[out] ppAsync

Puntero a una interfaz IVdsAsync que, tras la finalización correcta, recibe la interfaz IVdsAsync para supervisar y controlar esta operación. Los autores de llamadas deben liberar la interfaz recibida cuando hayan terminado con ella. Si se llama al método IVdsAsync::Wait en la interfaz y se devuelve un valor HRESULT correcto, las interfaces devueltas en la estructura de VDS_ASYNC_OUTPUT deben liberarse llamando al método IUnknown::Release en cada puntero de interfaz. Sin embargo, si Wait devuelve un valor HRESULT de error o si el parámetro pHrResult de Wait recibe un valor HRESULT de error, los punteros de interfaz de la estructura VDS_ASYNC_OUTPUT son NULL y no es necesario liberar. Puede probar los valores HRESULT correctos o erróneos mediante las macros SUCCEEDED y FAILED definidas en Winerror.h.

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 devuelto Descripción
S_OK
 El método se completó correctamente.

Comentarios

Un disco virtual solo se puede combinar si está desasociado.

Este método mueve todos los bloques de datos del disco secundario al elemento primario. Sin embargo, no eliminará los discos secundarios invalidados al final de la operación.

El disco virtual debe haberse abierto con acceso de lectura y escritura.

Requisitos

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

Consulte también

IVdsOpenVDisk