IVssBackupComponents::AddRestoreSubcomponent-Methode (vsbackup.h)
Die AddRestoreSubcomponent-Methode gibt an, dass ein Teilkomponentenelement eines Komponentensatzes, das für die Sicherung als nicht auswählbar markiert wurde, aber für die Wiederherstellung als auswählbar markiert wurde, unabhängig davon wiederhergestellt werden soll, ob ein anderes Element des Komponentensatzes wiederhergestellt wird.
Syntax
HRESULT AddRestoreSubcomponent(
[in] VSS_ID writerId,
[in] VSS_COMPONENT_TYPE componentType,
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszComponentName,
[in] LPCWSTR wszSubComponentLogicalPath,
[in] LPCWSTR wszSubComponentName,
[in] bool bRepair
);
Parameter
[in] writerId
Writer-Klassenbezeichner.
[in] componentType
Gibt den Typ der Komponente an. Mögliche Rückgabewerte finden Sie in der Dokumentation für VSS_COMPONENT_TYPE .
[in] wszLogicalPath
Breite Null-Zeichenfolge, die den logischen Pfad der Komponente im Sicherungsdokument enthält, der den Sicherungskomponentensatz definiert, der den Teilkomponentensatz enthält, der zur Wiederherstellung hinzugefügt werden soll.
Der Wert dieses Parameters 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
Breite Null-Zeichenfolge, die den logischen Pfad der Komponente im Sicherungsdokument enthält, der den Sicherungskomponentensatz definiert, der den Teilkomponentensatz enthält, der zur Wiederherstellung hinzugefügt werden soll.
Der Wert dieses Parameters darf nicht NULL sein.
Es gibt keine Einschränkungen für die Zeichen, die in einem Nicht-NULL-Komponentennamen angezeigt werden können.
[in] wszSubComponentLogicalPath
Breite NULL-Zeichenfolge, die den logischen Pfad des Teilkomponentens enthält, der für die Wiederherstellung hinzugefügt werden soll.
Beim Hinzufügen eines Teilkomponentens ist ein logischer Pfad erforderlich. Daher kann der Wert dieses Parameters nicht NULL sein.
Es gibt keine Einschränkungen für die Zeichen, die in einem logischen Pfad ohne NULL angezeigt werden können.
[in] wszSubComponentName
Breite Null-Zeichenfolge, die den logischen Namen der Teilkomponente enthält, die für die Wiederherstellung hinzugefügt werden soll.
Der Wert dieses Parameters darf nicht NULL sein.
Es gibt keine Einschränkungen für die Zeichen, die in einem Nicht-NULL-Komponentennamen angezeigt werden können.
[in] bRepair
Dieser Parameter ist für die zukünftige Verwendung reserviert. Dieser Parameter sollte immer auf false festgelegt werden .
Rückgabewert
Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.
| Wert | Bedeutung |
|---|---|
|
Der Wiederherstellungsunterkomponenten wurde erfolgreich hinzugefügt. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen. |
|
Das Sicherungskomponentenobjekt wird nicht initialisiert, diese Methode wurde während eines Wiederherstellungsvorgangs nicht aufgerufen oder diese Methode wurde nicht in der richtigen Sequenz aufgerufen. |
|
Das XML-Dokument ist ungültig. Überprüfen Sie das Ereignisprotokoll auf Details. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. |
|
Die Komponente ist nicht vorhanden. |
|
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
Vor dem Aufrufen von AddRestoreSubcomponent muss die von den Parametern wszLogicalPath und wszComponentName definierte Stammkomponente zunächst für die Wiederherstellung mithilfe von IVssBackupComponents::SetSelectedForRestore ausgewählt werden.
Wenn ein Anforderer das Wiederherstellen von Unterkomponenten unterstützen soll, muss diese Methode vor IVssBackupComponents::P reRestore aufgerufen werden.
AddRestoreSubcomponent ist für den Fall vorgesehen, in dem alle Dateien im Komponentensatz eines Writers als Einheit gesichert werden müssen, wobei es jedoch wünschenswert ist, dass ausgewählte Dateien (Unterkomponenten) einzeln wiederhergestellt werden können.
Um an einer solchen Wiederherstellung teilzunehmen, muss für eine Unterkomponente das bSelectableForRestore-Element von VSS_COMPONENTINFO auf TRUE festgelegt sein. Die durch die Parameter wszLogicalPath und wszComponentName definierte Komponente muss auch für die Wiederherstellung mit IVssBackupComponents::SetSelectedForRestore ausgewählt werden.
Weitere Informationen finden Sie unter Arbeiten mit Auswahl für Wiederherstellung und Unterkomponenten .
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vsbackup.h (einschließlich VsBackup.h, Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |