IVssCreateWriterMetadata::AddDatabaseLogFiles-Methode (vswriter.h)
Die AddDatabaseLogFiles-Methode gibt die Protokolldateien an, die einer zu sichernden Datenbank zugeordnet sind, sowie deren Speicherort.
Syntax
HRESULT AddDatabaseLogFiles(
[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 Datenbankkomponente enthält, der die Protokolldateien hinzugefügt werden.
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 Datenbankkomponente enthält, die den Protokolldateien zugeordnet ist. Der Typ dieser Komponente muss VSS_CT_DATABASE sein. Andernfalls gibt die Methode einen Fehler zurück.
[in] wszPath
Zeiger auf eine breite NULL-Zeichenfolge, die den Pfad des Verzeichnisses enthält, das die Protokolldateien enthält.
Das Verzeichnis kann ein lokales Verzeichnis auf dem VSS-Computer oder ein Dateifreigabeverzeichnis auf einem Remotedateiserver sein.
UNC-Pfade werden unterstützt.
Der Pfad kann Umgebungsvariablen (z. B. %SystemRoot%) enthalten, aber keine Feldhalterzeichen enthalten.
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 breite NULL-Zeichenfolge, die die Dateispezifikation der Protokolldateien 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 Enumerationswerten, um anzugeben, ob ein Writer die Datei für die Teilnahme an einer bestimmten Art 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, oder der Aufrufer hat versucht, einer Nicht-Datenbankkomponente Datenbankdateien hinzuzufügen. |
|
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 unter Windows 8 und Windows Server 2012 unterstützt. 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 AddDatabaseLogFiles (nach der Auflösung aller Umgebungsvariablen) in diesem Format vorliegen.
Diese Methode kann für eine bestimmte Datenbankkomponente mehrmals aufgerufen werden, die möglicherweise erforderlich ist, wenn mehrere Protokolldateien auf separaten Volumes gespeichert werden.
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
| 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 |