IVssCreateExpressWriterMetadata::AddFilesToFileGroup-Methode (vswriter.h)
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 |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Einer der Parameterwerte ist ungültig, oder der Aufrufer hat versucht, Dateigruppendateien zu einer Nicht-Dateigruppenkomponente 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. |
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 |