Método IVssBackupComponents::ImportSnapshots (vsbackup.h)

Artículo
03/13/2024

El método ImportSnapshots importa instantáneas transportadas desde una máquina diferente.

Nota Este método solo se admite en sistemas operativos Windows Server y para proveedores de hardware del Servicio de instantáneas de volumen.

Sintaxis

HRESULT ImportSnapshots(
  [out] IVssAsync **ppAsync
);

Parámetros

[out] ppAsync

Puntero indirecto doblemente a un objeto IVssAsync que contiene los datos de estado de instantánea importados.

Valor devuelto

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

Valor	Significado
S_OK	Devolvió correctamente un puntero a una instancia de la interfaz IVssAsync . Consulte la página de referencia de IVssAsync::QueryStatus para ver los códigos de error devueltos en el parámetro pHrResult .
E_ACCESSDENIED	El autor de la llamada no tiene suficientes privilegios de copia de seguridad o no es un administrador.
E_INVALIDARG	El parámetro ppAsync no apunta a un puntero válido; es decir, es NULL.
E_OUTOFMEMORY	El autor de la llamada no tiene memoria u otros recursos del sistema.
VSS_E_BAD_STATE	El objeto de componentes de copia de seguridad no se inicializa, se ha llamado a este método durante una operación de restauración o no se ha llamado a este método desde dentro de la secuencia correcta.
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.

Comentarios

Solo se puede importar una instantánea a la vez.

El solicitante es responsable de serializar la operación de instantánea de importación.

El autor de la llamada es responsable de liberar la interfaz IVssAsync .

Para obtener más información sobre la importación de instantáneas, vea Importación de volúmenes de instantáneas transportables.

Instantáneas transportables en un clúster: Para obtener más información sobre el uso de instantáneas transportables en un clúster, consulte Recuperación rápida mediante volúmenes de instantáneas transportables. La instantánea transportable debe importarse desde fuera del clúster siempre que el volumen original se monte dentro del clúster.

Nota Si se produce un error en la importación de instantáneas, el servicio de instantáneas de volumen no limpiará los LUN por sí solos. El solicitante tiene que iniciar la limpieza de LUN.

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2008, Windows Server 2003 con SP1, Windows Server 2003 Datacenter, Windows Server 2003 Enterprise [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	vsbackup.h (incluya VsBackup.h, Vss.h, VsWriter.h)
Library	VssApi.lib