Compartir a través de

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

  • Artículo

Se llama al método OnLunEmpty cada vez que VSS determina que un LUN de instantánea no contiene datos interesantes. Todas las instantáneas se han eliminado (lo que también provoca la eliminación del LUN). El proveedor puede reclamar los recursos LUN y reutilizarlos para otro propósito. VSS desmontará los volúmenes afectados. Un proveedor no debe emitir un nuevo examen durante OnLunEmpty. VSS controlará esta limpieza.

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

Sintaxis

HRESULT OnLunEmpty(
  [in] VSS_PWSZ            wszDeviceName,
  [in] VDS_LUN_INFORMATION *pInformation
);

Parámetros

[in] wszDeviceName

Dispositivo correspondiente al LUN que contiene la instantánea que se va a eliminar.

[in] pInformation

Puntero a una estructura de VDS_LUN_INFORMATION que contiene información sobre el LUN que contiene la instantánea que se va a eliminar.

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_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.

Comentarios

Los proveedores de hardware deben eliminar una instantánea y reclamar el LUN si y solo si
Se llama a OnLunEmpty. Una instantánea de hardware se puede usar como medio de copia de seguridad, por lo que los LUN deben tratarse con la misma atención que la matriz de almacenamiento trata los LUN usados para los discos normales. La reclamación de LUN fuera del procesamiento de OnLunEmpty debe limitarse a una emergencia o a un administrador que realice una acción explícita manualmente.

En el caso de instantáneas persistentes, el solicitante elimina la instantánea cuando ya no es necesaria. En el caso de instantáneas de liberación automática no persistente, el servicio VSS elimina la instantánea cuando el solicitante llama a IUnknown::Release en el objeto IVssBackupComponents . En el caso de instantáneas que no son de versión automática no persistente, el servicio VSS elimina la instantánea cuando se reinicia el equipo. En todos los casos, el servicio VSS llama al método OnLunEmpty del proveedor según sea necesario para cada LUN de instantánea.

Tenga en cuenta que Se llama a OnLunEmpty de la mejor manera posible. VSS invoca el método solo cuando se garantiza que el LUN está vacío. Puede haber muchos casos en los que el LUN está vacío, pero VSS no puede detectarlo debido a errores o circunstancias externas. En este caso, el usuario debe usar el software de administración de almacenamiento para borrar este estado.

He aquí algunos ejemplos:

  • Cuando un LUN de instantánea se mueve a un host diferente, pero no se transporta o importa realmente a través de VSS, ese LUN aparece como cualquier otro LUN y los volúmenes se pueden eliminar simplemente sin ninguna notificación de VSS.
  • Un bloqueo o reinicio inesperado en medio de una creación de instantáneas.
  • Importación cancelada.

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