IVssCreateExpressWriterMetadata::AddFilesToFileGroup-Methode (vswriter.h)

Artikel
08/27/2023

Fügt einer angegebenen Dateigruppenkomponente für einen Express Writer einen Dateisatz (eine angegebene Datei oder Dateien) hinzu.

Syntax

HRESULT AddFilesToFileGroup(
  [in] LPCWSTR wszLogicalPath,
  [in] LPCWSTR wszGroupName,
  [in] LPCWSTR wszPath,
  [in] LPCWSTR wszFilespec,
  [in] bool    bRecursive,
  [in] LPCWSTR wszAlternateLocation,
  [in] DWORD   dwBackupTypeMask
);

Parameter

[in] wszLogicalPath

Ein Zeiger auf eine mit NULL beendete breite Zeichenfolge, die den logischen Pfad (der null sein kann) der Komponente enthält, der die Dateien hinzugefügt werden sollen. Weitere Informationen finden Sie unter Logisches Pathing von Komponenten.

[in] wszGroupName

Ein Zeiger auf eine mit NULL beendete breite Zeichenfolge, die den Namen der Dateigruppenkomponente enthält. Der Typ dieser Komponente muss VSS_CT_FILEGROUP sein. Andernfalls gibt die Methode einen Fehler zurück.

[in] wszPath

Ein Zeiger auf eine mit NULL beendete breite Zeichenfolge, die das Standardstammverzeichnis der hinzuzufügenden Dateien enthält.

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

Ein Zeiger auf eine mit NULL beendete breite Zeichenfolge, die die Dateispezifikation der eingeschlossenen Dateien enthält.

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

[in] bRecursive

Ein boolescher Wert, der angibt, ob der vom wszPath-Parameter angegebene Pfad nur ein einzelnes Verzeichnis identifiziert oder ob er eine Hierarchie von Verzeichnissen angibt, die rekursiv durchlaufen werden sollen. Dieser Parameter sollte auf true festgelegt werden, wenn der Pfad als Hierarchie von Verzeichnissen behandelt wird, durch die rekursiert werden soll, oder andernfalls false .

Informationen zum Durchlaufen von eingebundenen Ordnern finden Sie unter Arbeiten mit eingebundenen Ordnern und Analysepunkten.

[in] wszAlternateLocation

Dieser Parameter ist reserviert und muss NULL sein.

[in] dwBackupTypeMask

Eine Bitmaske von VSS_FILE_SPEC_BACKUP_TYPE Enumerationswerte, um anzugeben, ob ein Writer die Datei für die Teilnahme an einer bestimmten Art von Sicherungsvorgängen auswerten soll.

Dieser Parameter kann keine VSS_FSBT_DIFFERENTIAL_BACKUP_REQUIRED, VSS_FSBT_INCREMENTAL_BACKUP_REQUIRED oder VSS_FSBT_LOG_BACKUP_REQUIRED enthalten.

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, Dateigruppendateien zu einer Nicht-Dateigruppenkomponente 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.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	vswriter.h (einschließlich Vss.h, VsWriter.h)
Bibliothek	VssApi.lib

Weitere Informationen

IVssCreateExpressWriterMetadata

Freigeben über