Compartir a través de


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

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 pwszSharePath,
  [in] LONG     lNewContext,
  [in] VSS_ID   ProviderId
);

Parámetros

[in] SnapshotSetId

Identificador del conjunto de instantáneas.

[in] SnapshotId

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

[in] pwszSharePath

Ruta de acceso del recurso compartido de archivos.

[in] lNewContext

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

[in] ProviderId

La identificación del proveedor.

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 8.1 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado vsprov.h
Library VssApi.lib

Consulte también

IVssFileShareSnapshotProvider