IVssCreateWriterMetadata::AddDatabaseFiles-Methode (vswriter.h)
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 |
|---|---|
|
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. |
|
Die angegebene 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
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 |