Freigeben über


IVssHardwareSnapshotProvider::OnLunEmpty-Methode (vsprov.h)

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

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

Syntax

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

Parameter

[in] wszDeviceName

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

[in] pInformation

Zeiger auf eine VDS_LUN_INFORMATION-Struktur , die Informationen über die LUN enthält, die die zu löschende Schattenkopie enthält.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode/-wert BESCHREIBUNG
S_OK
0x00000000L
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
Ein unerwarteter Anbieterfehler ist aufgetreten. Der Anbieter muss ein Ereignis im Anwendungsereignisprotokoll melden und dem Benutzer Informationen zum Beheben des Problems bereitstellen.

Hinweise

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 reguläre Datenträger verwendet werden. Das Abrufen von LUNs außerhalb der Verarbeitung für OnLunEmpty sollte auf einen Notfall oder einen Administrator beschränkt sein, der eine explizite Aktion manuell ausführt.

Bei persistenten Schattenkopien löscht der Anforderer die Schattenkopie, wenn sie nicht mehr benötigt wird. Bei nichtpersistenten Schattenkopien mit automatischer Freigabe löscht der VSS-Dienst die Schattenkopie, wenn der Anforderer IUnknown::Release für das IVssBackupComponents-Objekt aufruft . Bei nichtpersistenten 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 bei 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 der 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.

Einige Beispiele:

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Nicht unterstützt
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vsprov.h

Weitere Informationen

IVssHardwareSnapshotProvider