Compartir a través de

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

  • Artículo

VSS llama a este método para cada instantánea que se agrega al conjunto de instantáneas.

Sintaxis

HRESULT BeginPrepareSnapshot(
  [in] VSS_ID   SnapshotSetId,
  [in] VSS_ID   SnapshotId,
  [in] VSS_PWSZ pwszVolumeName,
  [in] LONG     lNewContext
);

Parámetros

[in] SnapshotSetId

Identificador del conjunto de instantáneas.

[in] SnapshotId

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

[in] pwszVolumeName

Cadena de caracteres anchos terminada en NULL que contiene el nombre del volumen. El nombre debe tener uno de los siguientes formatos y debe incluir una barra diagonal inversa final (\):

  • Ruta de acceso de una carpeta montada, por ejemplo, Y:\MountX\
  • Una letra de unidad, por ejemplo, D:\
  • Ruta de acceso GUID de volumen con el formato \\?\Volume{GUID}\ (donde GUID identifica el volumen)

[in] lNewContext

Contexto del conjunto de instantáneas. Este contexto consta de una máscara de bits de _VSS_VOLUME_SNAPSHOT_ATTRIBUTES valores.

Valor devuelto

A continuación se muestran los códigos de retorno válidos para este método.

Valor Significado
S_OK
 La instantánea se creó correctamente.
E_ACCESSDENIED
 El autor de la llamada no tiene suficientes privilegios de copia de seguridad o no es un administrador.
E_INVALIDARG
 Uno de los valores de parámetro no es válido.
E_OUTOFMEMORY
 El autor de la llamada no tiene memoria u otros recursos del sistema.
VSS_E_OBJECT_NOT_FOUND
 No se encontró el volumen especificado.
VSS_E_PROVIDER_VETO
 Error del proveedor. El proveedor registró el error en el registro de eventos. Para obtener más información, vea Control de eventos y errores en VSS.
VSS_E_UNSUPPORTED_CONTEXT
 No se admite el contexto especificado.
VSS_E_VOLUME_NOT_SUPPORTED_BY_PROVIDER
 El proveedor no admite el volumen especificado.
VSS_E_UNEXPECTED
 error inesperado. El código de error se registra en el archivo de registro de errores. Para obtener más información, vea Control de eventos y errores en VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite hasta Windows Server 2008 R2 y Windows 7. E_UNEXPECTED se usa en su lugar.

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 vsprov.h
Library VssApi.lib

Consulte también

IVssSoftwareSnapshotProvider