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.
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 |
---|---|
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
Nicht genügend Arbeitsspeicher oder andere Systemressourcen. |
|
Einer der Parameterwerte ist ungültig. |
|
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 |