Freigeben über


IVssHardwareSnapshotProvider::OnLunEmpty-Methode (vsprov.h)

Die OnLunEmpty-Methode wird aufgerufen, wenn VSS bestimmt, dass eine Schattenkopie LUN keine interessanten Daten enthält. Alle Schattenkopien wurden gelöscht (was auch zum Löschen des LUN führt.) Die LUN-Ressourcen können vom Anbieter zurückgefordert und für einen anderen Zweck wiederverwendet werden. VSS hebt die Bereitstellung betroffener Volumes auf. Ein Anbieter sollte während der OnLunEmpty-Zeit keinen Erneutscan ausgeben. VSS behandelt diese Bereinigung.

Anmerkung Hardwareanbieter werden nur unter Windows Server-Betriebssystemen unterstützt.
 

Syntax

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

Die Parameter

[in] wszDeviceName

Gerät, das der LUN entspricht, die die zu löschende Schattenkopie enthält.

[in] pInformation

Zeigen Sie auf eine VDS_LUN_INFORMATION Struktur, die Informationen zum LUN enthält, die die zu löschende Schattenkopie enthält.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Zurückgeben von Code/Wert Description
S_OK
0x000000000L
Der Vorgang wurde erfolgreich abgeschlossen.
E_OUTOFMEMORY
0x8007000EL
Nicht genügend Arbeitsspeicher oder andere Systemressourcen.
E_INVALIDARG
0x80070057L
Einer der Parameterwerte ist ungültig.
VSS_E_PROVIDER_VETO
0x80042306L
Unerwarteter Anbieterfehler. Der Anbieter muss ein Ereignis im Anwendungsereignisprotokoll melden, das dem Benutzer Informationen zum Beheben des Problems liefert.

Bemerkungen

Hardwareanbieter sollten eine Schattenkopie löschen und die LUN nur dann zurückfordern, wenn
OnLunEmpty wird aufgerufen. Eine Hardwareschattenkopie kann als Sicherungsmedium selbst verwendet werden, daher sollten die LUNs mit der gleichen Sorgfalt behandelt werden, wie das Speicherarray LUNs behandelt, die für normale Datenträger verwendet werden. Das Zurückfordern von LUNs außerhalb der Verarbeitung für OnLunEmpty sollte auf den Notfall beschränkt sein oder ein Administrator, der explizite Aktionen manuell ausführt.

Bei dauerhaften Schattenkopien löscht der Antragsteller die Schattenkopie, wenn sie nicht mehr benötigt wird. Bei nichtpersistenten Auto-Release-Schattenkopien löscht der VSS-Dienst die Schattenkopie, wenn der Antragsteller IUnknown::Release für das IVssBackupComponents-Objekt aufruft. Im Falle nichtpersistenter Schattenkopien ohne automatische Freigabe löscht der VSS-Dienst die Schattenkopie, wenn der Computer neu gestartet wird. In allen Fällen ruft der VSS-Dienst die OnLunEmpty-Methode des Anbieters nach Bedarf für jede Schattenkopie-LUN auf.

Beachten Sie, dass OnLunEmpty auf best-effort-Basis aufgerufen wird. VSS ruft die Methode nur auf, wenn die LUN garantiert leer ist. Es kann viele Fälle geben, in denen die LUN leer ist, aber VSS kann dies aufgrund von Fehlern oder externen Umständen nicht erkennen. In diesem Fall sollte der Benutzer Speicherverwaltungssoftware verwenden, um diesen Zustand zu löschen.

Beispiele:

  • Wenn eine Schattenkopie LUN auf einen anderen Host verschoben, aber nicht tatsächlich über VSS transportiert oder importiert wird, wird diese LUN als beliebige andere LUN angezeigt, und Volumes können einfach ohne Benachrichtigung von VSS gelöscht werden.
  • Ein Absturz oder ein unerwarteter Neustart in der Mitte einer Schattenkopienerstellung.
  • Ein abgebrochener Import.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Nicht unterstützt
Mindestanforderungen für unterstützte Server Windows Server 2003 [Nur Desktop-Apps]
Zielplattform Fenster
Header vsprov.h

Siehe auch

IVssHardwareSnapshotProvider