IVssCreateWriterMetadata::AddComponent-Methode (vswriter.h)
Die AddComponent-Methode fügt eine Datenbank oder Dateigruppe als zu sichernde Komponente hinzu.
Syntax
HRESULT AddComponent(
[in] VSS_COMPONENT_TYPE ct,
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszComponentName,
[in] LPCWSTR wszCaption,
[in] const BYTE *pbIcon,
[in] UINT cbIcon,
[in] bool bRestoreMetadata,
[in] bool bNotifyOnBackupComplete,
[in] bool bSelectable,
[in] bool bSelectableForRestore,
[in] DWORD dwComponentFlags
);
Parameter
[in] ct
Ein VSS_COMPONENT_TYPE Enumerationswert, der den Typ der Komponente angibt.
Windows Server 2003 und Windows XP: Vor Windows Server 2003 mit SP1 ist dieser Parameter für die Systemverwendung reserviert, und der Aufrufer sollte den Standardwert nicht überschreiben.
[in] wszLogicalPath
Ein Zeiger auf eine mit NULL beendete breite Zeichenfolge, die den logischen Pfad der Datenbank oder Dateigruppe enthält. Weitere Informationen finden Sie unter Logisches Pathing von Komponenten.
Ein logischer Pfad ist optional und kann NULL sein.
[in] wszComponentName
Ein Zeiger auf eine mit NULL beendete breite Zeichenfolge, die den Namen der Komponente enthält. Diese Zeichenfolge ist nicht lokalisiert.
Dieser Parameter ist erforderlich und darf nicht NULL sein. Die Zeichenfolge darf keine umgekehrten Schrägstriche enthalten.
[in] wszCaption
Ein Zeiger auf eine mit NULL beendete breite Zeichenfolge, die eine Beschreibung (auch als "Anzeigename" bezeichnet) für die Komponente enthält. Diese Zeichenfolge kann lokalisiert sein, und daher müssen die Anforderer davon ausgehen, dass sie lokalisiert ist.
Dieser Parameter ist optional und kann NULL sein. Die Zeichenfolge kann umgekehrte Schrägstriche enthalten.
[in] pbIcon
Ein Zeiger auf eine Bitmap des Symbols, das die Datenbank darstellt, die in einer Benutzeroberfläche angezeigt werden soll. Die Größe des Puffers in Bytes wird durch den cbIcon-Parameter angegeben.
Wenn der Writer kein Symbol angeben möchte, sollte pbIcon auf NULL festgelegt werden.
[in] cbIcon
Die Größe des Cookies in Bytes. Wenn der pbIcon-ParameterNULL ist, sollte cbIcon 0 sein.
[in] bRestoreMetadata
Dieser Parameter ist für die zukünftige Verwendung reserviert und sollte immer auf false festgelegt werden.
[in] bNotifyOnBackupComplete
Dieser Parameter ist für die zukünftige Verwendung reserviert und sollte immer auf false festgelegt werden.
[in] bSelectable
Ein boolescher Wert, der angibt, ob die Komponente optional gesichert werden kann (was bedeutet, dass sie aus der Sicherung ausgeschlossen werden kann) oder immer gesichert wird, wenn eine der Komponenten des Writers gesichert wird. Der Boolesche Wert ist true , wenn die Komponente selektiv gesichert werden kann, und false , wenn sie gesichert wird, wenn eine der Komponenten gesichert wird.
[in] bSelectableForRestore
Ein boolescher Wert, der bestimmt, ob eine Komponente einzeln wiederhergestellt werden kann, wenn sie nicht explizit in das Sicherungsdokument eingeschlossen wurde. Wenn die Komponente explizit dem Sicherungsdokument hinzugefügt wurde, kann sie für die Wiederherstellung immer einzeln ausgewählt werden. in diesem Fall hat dieses Flag keine Bedeutung.
Wenn true, kann die Komponente selbst wiederhergestellt werden. wenn false, kann die Komponente nur wiederhergestellt werden, wenn der gesamte Komponentensatz wiederhergestellt wird. (Weitere Informationen finden Sie unter VSS_COMPONENTINFO und Arbeiten mit Auswählbarkeit und logischen Pfaden ).
Der Standardwert für diesen Parameter ist false.
[in] dwComponentFlags
Eine Bitmaske (oder bitweise OR) von Membern der VSS_COMPONENT_FLAGS-Enumeration , die die von dieser Komponente unterstützten Features angibt.
Der Standardwert für dieses Argument ist 0.
Rückgabewert
Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.
| Wert | Bedeutung |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen. |
|
Das XML-Dokument ist ungültig. Überprüfen Sie das Ereignisprotokoll auf Details. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. |
|
Das Objekt ist ein Duplikat. Eine Komponente mit demselben logischen Pfad und Komponentennamen ist bereits 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
Diese Methode kann mehrmals aufgerufen werden, um den Metadaten eines Writers mehrere Komponenten hinzuzufügen.
Die Kombination aus logischem Pfad und Name für jede Komponente einer bestimmten instance einer bestimmten Klasse von Writer muss eindeutig sein. Der Versuch, AddComponent zweimal mit denselben Werten wie wszLogicalPath und wszComponentName aufzurufen, führt zu einem VSS_E_OBJECT_ALREADY_EXISTS Fehler.
AddComponent kann verwendet werden, um Unterkomponenten hinzuzufügen– Komponenten, in denen alle Memberdateien als Gruppe gesichert werden, aber Dateien enthalten, die einzeln wiederhergestellt werden können. 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 | vswriter.h (einschließlich Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |