IVssCreateWriterMetadata::AddDatabaseLogFiles-Methode (vswriter.h)

  • Artikel

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
S_OK
 Der Vorgang wurde durchgeführt.
E_INVALIDARG
 Einer der Parameterwerte ist ungültig, oder der Aufrufer hat versucht, einer Nicht-Datenbankkomponente Datenbankdateien hinzuzufügen.
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 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

Weitere Informationen

IVssCreateWriterMetadata

IVssCreateWriterMetadata::AddComponent