IVssCreateWriterMetadata::AddDatabaseFiles-Methode (vswriter.h)

  • Artikel

Die AddDatabaseFiles-Methode gibt den Dateisatz (die angegebenen Dateien) an, aus denen die zu sichernde Datenbankkomponente besteht.

Syntax

HRESULT AddDatabaseFiles(
  [in] LPCWSTR wszLogicalPath,
  [in] LPCWSTR wszDatabaseName,
  [in] LPCWSTR wszPath,
  [in] LPCWSTR wszFilespec,
  [in] DWORD   dwBackupTypeMask
);

Parameter

[in] wszLogicalPath

Zeiger auf eine breite NULL-Zeichenfolge, die den logischen Pfad der Komponente enthält, der die Datenbank hinzugefügt wird.

Weitere Informationen finden Sie unter Logisches Pathing von Komponenten.

Ein logischer Pfad ist nicht erforderlich und kann NULL sein.

[in] wszDatabaseName

Zeiger auf eine mit NULL beendete breite Zeichenfolge, die den Namen der Datenbank enthält.

Dieser Name ist erforderlich und muss mit dem Namen der Komponente übereinstimmen, der die Datenbank hinzugefügt wird.

[in] wszPath

Zeiger auf eine breite NULL-Zeichenfolge, die den Pfad des Verzeichnisses enthält, das die Datenbankdatei enthält.

Der Pfad kann Umgebungsvariablen (z. B. %SystemRoot%) enthalten, aber keine Feldhalterzeichen enthalten.

UNC-Pfade werden unterstützt.

Es ist nicht erforderlich, dass der Pfad mit einem umgekehrten Schrägstrich ("") endet. Anwendungen, die diese Informationen abrufen, müssen überprüft werden.

[in] wszFilespec

Zeiger auf eine mit NULL beendete breite Zeichenfolge, die die Dateispezifikation der Datei bzw. der Dateien enthält, die der Datenbank zugeordnet sind.

Eine Dateispezifikation kann keine Verzeichnisspezifikationen enthalten (z. B. keine umgekehrten Schrägstriche), kann aber den enthalten. und * Platzhalterzeichen.

[in] dwBackupTypeMask

Eine Bitmaske (oder bitweise OR) von VSS_FILE_SPEC_BACKUP_TYPE Enumerationswerte, um anzugeben, ob ein Writer die Datei für die Teilnahme an bestimmten Arten von Sicherungsvorgängen auswerten soll.

Der Standardwert für dieses Argument ist (VSS_FSBT_ALL_BACKUP_REQUIRED | VSS_FSBT_ALL_SNAPSHOT_REQUIRED).

Rückgabewert

Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.

Wert Bedeutung
S_OK
 Der Vorgang wurde durchgeführt.
E_INVALIDARG
 Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY
 Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen.
VSS_E_INVALID_XML_DOCUMENT
 Das XML-Dokument ist ungültig. Überprüfen Sie das Ereignisprotokoll auf Details. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS.
VSS_E_OBJECT_NOT_FOUND
 Die angegebene Komponente ist nicht vorhanden.
VSS_E_UNEXPECTED
 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

Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP und Windows Server 2003: Remotedateifreigaben werden erst unterstützt, wenn Windows 8 und Windows Server 2012. Writer unterstützen nur lokale Ressourcen– Dateien, deren absoluter Pfad mit einer gültigen lokalen Volumespezifikation beginnt und kein zugeordnetes Netzlaufwerk sein kann. Daher müssen Pfadeingaben (wszPath) zu AddDatabaseFiles (nach der Auflösung aller Umgebungsvariablen) in diesem Format vorliegen.

Diese Methode kann für eine bestimmte Datenbank mehrmals aufgerufen werden. Dies geschieht, wenn die Datenbank in Dateien vorhanden ist, die auf separaten Volumes gespeichert sind, wie es mit Microsoft SQL Server möglich ist.

Die Werte der Parameter wszLogicalPath und wszDatabaseName sollten mit denen einer der Datenbankkomponenten übereinstimmen, die zuvor mit der IVssCreateWriterMetadata::AddComponent-Methode hinzugefügt wurden.

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

Weitere Informationen

IVssCreateWriterMetadata

IVssCreateWriterMetadata::AddComponent