IVssBackupComponentsEx::SetSelectedForRestoreEx-Methode (vsbackup.h)
Die SetSelectedForRestoreEx-Methode gibt an, ob die angegebene auswählbare Komponente für die Wiederherstellung in einem angegebenen Writer-instance ausgewählt ist.
Syntax
HRESULT SetSelectedForRestoreEx(
[in] VSS_ID writerId,
[in] VSS_COMPONENT_TYPE ct,
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszComponentName,
[in] bool bSelectedForRestore,
[in] VSS_ID instanceId
);
Parameter
[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 beim Hinzufügen der Komponente verwendet 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 der IVssBackupComponents::AddComponent-Methode enthalten.
[in] bSelectedForRestore
Wenn der Wert dieses Parameters true ist, wurde die ausgewählte Komponente für die Wiederherstellung ausgewählt. Wenn der Wert false ist, wurde die ausgewählte Komponente nicht für die Wiederherstellung ausgewählt.
[in] instanceId
GUID des Writer-instance.
Der Standardwert für diesen Parameter ist GUID_NULL.
Rückgabewert
Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.
| Wert | Bedeutung |
|---|---|
|
Es wurde erfolgreich angegeben, dass die angegebene Komponente für die Wiederherstellung ausgewählt wurde. |
|
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 ausgewählte Komponente ist im Dokument Sicherungskomponenten nicht vorhanden, oder ein Live-instance des Writers, der dieser Komponente entspricht, wird nicht auf dem System ausgeführt. |
|
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
SetSelectedForRestoreEx, das eine Komponente in eine andere Writer-instance verschiebt, kann nur für einen Writer aufgerufen werden, der die Ausführung mehrerer Writerinstanzen mit derselben Klassen-ID unterstützt und einen Anforderer unterstützt, der eine Komponente zum Zeitpunkt der Wiederherstellung an einen anderen Writer instance verschiebt. Um festzustellen, ob ein Writer diese Unterstützung bereitstellt, rufen Sie die IVssExamineWriterMetadata::GetBackupSchema-Methode auf.
SetSelectedForRestoreEx hat nur eine Bedeutung für Wiederherstellungen, die im Komponentenmodus ausgeführt werden.
SetSelectedForRestoreEx kann nur für Komponenten aufgerufen werden, die zum Zeitpunkt der Sicherung explizit mit AddComponent dem Sicherungsdokument hinzugefügt wurden. Das Wiederherstellen einer Komponente, die implizit als Teil eines Komponentensatzes für die Sicherung ausgewählt wurde, muss durch Aufrufen von SetSelectedForRestoreEx für die nächstgelegene Vorgängerkomponente erfolgen, die dem Dokument hinzugefügt wurde. Wenn nur die Daten dieser Komponente wiederhergestellt werden sollen, sollte dies über die IVssBackupComponents::AddRestoreSubcomponent-Methode erreicht werden. Dies kann nur erfolgen, wenn die Komponente für die Wiederherstellung ausgewählt werden kann (siehe Arbeiten mit Auswählbarkeit und logischen Pfaden).
Diese Methode muss vor der IVssBackupComponents::P reRestore-Methode aufgerufen werden.
Die Unterscheidung zwischen den Parametern instanceId und writerID ist erforderlich, da es möglich ist, dass mehrere Instanzen desselben Writers auf dem Computer ausgeführt werden.
Wenn der Wert des instanceId-Parameters GUID_NULL ist, entspricht dies dem Aufrufen der IVssBackupComponents::SetSelectedForRestore-Methode .
Der Parameter instanceId wird verwendet, um anzugeben, dass die Komponente in einem anderen Writer-instance wiederhergestellt werden soll. Wenn der Wert des instanceId-Parameters nicht GUID_NULL ist, muss er mit der instance-ID eines Writer-instance mit derselben writer-Klassen-ID übereinstimmen, die im writerID-Parameter angegeben ist.
Der Klassenbezeichner eines Writers, instance Bezeichner und instance Name finden Sie, indem Sie die IVssExamineWriterMetadataEx::GetIdentityEx-Methode aufrufen.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008, Windows Server 2003 mit SP1 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vsbackup.h (enthalten VsBackup.h, Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |
Weitere Informationen
IVssBackupComponents::SetSelectedForRestore