IVssBackupComponents::ImportSnapshots-Methode (vsbackup.h)

Artikel
08/27/2023

Die ImportSnapshots-Methode importiert Schattenkopien , die von einem anderen Computer übertragen werden.

Hinweis Diese Methode wird nur unter Windows Server-Betriebssystemen und für Hardwareanbieter des Volume Shadow Copy Service unterstützt.

Syntax

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

Parameter

[out] ppAsync

Doppelt indirekter Zeiger auf ein IVssAsync-Objekt, das die importierte Schattenkopie status Daten enthält.

Rückgabewert

Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.

Wert	Bedeutung
S_OK	Es wurde erfolgreich ein Zeiger auf eine instance der IVssAsync-Schnittstelle zurückgegeben. Die im pHrResult-Parameter zurückgegebenen Fehlercodes finden Sie auf der Referenzseite für IVssAsync:QueryStatus.
E_ACCESSDENIED	Der Aufrufer verfügt nicht über ausreichende Sicherungsberechtigungen oder ist kein Administrator.
E_INVALIDARG	Der ppAsync-Parameter zeigt nicht auf einen gültigen Zeiger. Das heißt, es ist NULL.
E_OUTOFMEMORY	Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen.
VSS_E_BAD_STATE	Das Sicherungskomponentenobjekt wird nicht initialisiert, diese Methode wurde während eines Wiederherstellungsvorgangs aufgerufen oder diese Methode wurde nicht innerhalb der richtigen Sequenz aufgerufen.
VSS_E_UNEXPECTED	Unerwarteter Fehler. Der Fehlercode wird in der Fehlerprotokolldatei protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird erst unter Windows Server 2008 R2 und Windows 7 unterstützt. stattdessen wird E_UNEXPECTED verwendet.

Hinweise

Es kann jeweils nur eine Schattenkopie importiert werden.

Der Anforderer ist für die Serialisierung des Importschattenkopievorgangs verantwortlich.

Der Aufrufer ist für die Freigabe der IVssAsync-Schnittstelle verantwortlich.

Weitere Informationen zum Importieren von Schattenkopien finden Sie unter Importieren von transportablen schattenkopierten Volumes.

Transportierbare Schattenkopien in einem Cluster: Ausführliche Informationen zur Verwendung transportabler Schattenkopien in einem Cluster finden Sie unter Schnelle Wiederherstellung mit transportablen schattenkopierte Volumes. Die transportierbare Schattenkopie muss von außerhalb des Clusters importiert werden, solange das ursprüngliche Volume im Cluster eingebunden ist.

Hinweis Wenn beim Schattenkopieimport ein Fehler auftritt, sauber der Volumeschattenkopie-Dienst keine LUNs alleine auf. Der Anforderer muss die Bereinigung von LUNs initiieren.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008, Windows Server 2003 mit SP1, Windows Server 2003 Datacenter, Windows Server 2003 Enterprise [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	vsbackup.h (einschließlich VsBackup.h, Vss.h, VsWriter.h)
Bibliothek	VssApi.lib