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.

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

Weitere Informationen

IVssCreateWriterMetadata