IVssBackupComponents::SetBackupSucceededed-Methode (vsbackup.h)
Die SetBackupSucceeded-Methode gibt an, ob die Sicherung der angegebenen Komponente eines bestimmten Writer erfolgreich war.
Syntax
HRESULT SetBackupSucceeded(
[in] VSS_ID instanceId,
[in] VSS_ID writerId,
[in] VSS_COMPONENT_TYPE ct,
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszComponentName,
[in] bool bSucceded
);
Parameter
[in] instanceId
GuiD (Globally Unique Identifier) des Writer-instance.
[in] writerId
GuiD (Globally Unique Identifier) der Writer-Klasse.
[in] ct
Typ der Komponente. Die möglichen Werte finden Sie unter VSS_COMPONENT_TYPE .
[in] wszLogicalPath
Mit Null beendete Breitzeichenzeichenfolge, die den logischen Pfad der Komponente enthält.
Weitere Informationen finden Sie unter Logische Pfade von Komponenten.
Der Wert der Zeichenfolge, die den hier verwendeten logischen Pfad enthält, sollte dem Wert entsprechen, der verwendet wurde, als die Komponente mithilfe von IVssBackupComponents::AddComponent dem Sicherungssatz hinzugefügt wurde.
Der logische Pfad kann NULL sein.
Es gibt keine Einschränkungen für die Zeichen, die in einem logischen Pfad ohne NULL angezeigt werden können.
[in] wszComponentName
Breitzeichenzeichenfolge mit NULL-Beendigung, die den Namen der Komponente enthält.
Die Zeichenfolge darf nicht NULL sein und sollte denselben Komponentennamen wie beim Hinzufügen der Komponente zum Sicherungssatz mithilfe von IVssBackupComponents::AddComponent enthalten.
[in] bSucceded
Legen Sie diesen Parameter auf true fest, wenn die Komponente erfolgreich gesichert wurde, oder andernfalls false .
Rückgabewert
Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.
| Wert | Bedeutung |
|---|---|
|
Der Sicherungsstatus erfolgreich wurde erfolgreich festgelegt. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen. |
|
Das Sicherungskomponentenobjekt wird nicht initialisiert, diese Methode wurde während eines Wiederherstellungsvorgangs aufgerufen, oder diese Methode wurde nicht innerhalb der richtigen Sequenz aufgerufen. |
|
Die Sicherungskomponente ist nicht vorhanden. |
|
Das XML-Dokument ist ungültig. Überprüfen Sie das Ereignisprotokoll auf Details. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. |
|
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
Beim Arbeiten im Komponentenmodus (wenn IVssBackupComponents::SetBackupState aufgerufen wird, wobei das Argument select components auf true festgelegt ist), überprüfen Writer den Zustand der einzelnen Komponentensicherungen mithilfe von IVssComponent::GetBackupSucceeded. Daher muss eine gut verhaltene Sicherungsanwendung (Anforderer) SetBackupSucceeded aufrufen, nachdem jede Komponente verarbeitet wurde und bevor IVssBackupComponents::BackupComplete aufgerufen wird.
Rufen Sie diese Methode nicht auf, wenn der Aufruf von IVssBackupComponents::D oSnapshotSet fehlgeschlagen ist . Weitere Informationen zur Verwendung von DoSnapshotSet, SetBackupSucceeded und BackupComplete in einem Sicherungsvorgang finden Sie unter Übersicht über Aufgaben vor der Sicherung und Übersicht über die tatsächliche Sicherung von Dateien.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vsbackup.h (enthalten VsBackup.h, Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |
Weitere Informationen
IVssBackupComponents::BackupComplete