Compartir a través de

Método IVssHardwareSnapshotProvider::BeginPrepareSnapshot (vsprov.h)

  • Artículo

Se llama al método BeginPrepareSnapshot para cada instantánea que se agrega al conjunto de instantáneas.

Nota Los proveedores de hardware solo se admiten en sistemas operativos Windows Server.
 

Sintaxis

HRESULT BeginPrepareSnapshot(
  [in]      VSS_ID              SnapshotSetId,
  [in]      VSS_ID              SnapshotId,
  [in]      LONG                lContext,
  [in]      LONG                lLunCount,
  [in]      VSS_PWSZ            *rgDeviceNames,
  [in, out] VDS_LUN_INFORMATION *rgLunInformation
);

Parámetros

[in] SnapshotSetId

Identificador del conjunto de instantáneas.

[in] SnapshotId

Identificador de la instantánea que se va a crear.

[in] lContext

Contexto de instantánea para el conjunto de instantáneas actual como se enumera en _VSS_VOLUME_SNAPSHOT_ATTRIBUTES.

[in] lLunCount

Recuento de LUN que contribuyen a este volumen de instantáneas.

[in] rgDeviceNames

Puntero a la matriz de punteros lLunCount a cadenas, cada cadena que contiene el nombre de un LUN que se va a copiar en la sombra.

[in, out] rgLunInformation

Puntero a la matriz de estructuras de VDS_LUN_INFORMATION lLunCount, una para cada LUN que contribuye a este volumen de instantáneas.

Valor devuelto

Este método puede devolver uno de estos valores.

Código o valor devuelto Descripción
S_OK
0x00000000L
 La operación se completó correctamente.
E_OUTOFMEMORY
0x8007000EL
 Memoria insuficiente u otros recursos del sistema.
E_INVALIDARG
0x80070057L
 Uno de los valores de parámetro no es válido.
VSS_E_MAXIMUM_NUMBER_OF_VOLUMES_REACHED
0x80042312L
 El proveedor ha alcanzado el número máximo de volúmenes que puede admitir.
VSS_E_NESTED_VOLUME_LIMIT
 El volumen especificado se anida demasiado para participar en la operación de VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: No se admite este código de retorno.
VSS_E_PROVIDER_VETO
0x80042306L
 Error inesperado del proveedor. El proveedor debe notificar un evento en el registro de eventos de la aplicación que proporciona al usuario información sobre cómo resolver el problema.
VSS_E_VOLUME_NOT_SUPPORTED_BY_PROVIDER
0x8004230EL
 El proveedor no admite este volumen.
VSS_E_UNSUPPORTED_CONTEXT
0x8004231BL
 No se admite el contexto especificado por lContext .

Comentarios

No se puede llamar a este método para un disco duro virtual (VHD) anidado dentro de otro VHD.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: No se admiten discos duros virtuales.

Requisitos

Requisito Value
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado vsprov.h

Consulte también

IVssHardwareSnapshotProvider

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES