IVssCreateWriterMetadata::AddExcludeFiles-Methode (vswriter.h)
Die AddExcludeFiles-Methode wird verwendet, um einen Dateisatz (eine angegebene Datei oder Dateien) explizit auszuschließen, die andernfalls implizit eingeschlossen werden könnten, wenn eine Komponente des aktuellen Writer gesichert wird.
Syntax
HRESULT AddExcludeFiles(
[in] LPCWSTR wszPath,
[in] LPCWSTR wszFilespec,
[in] bool bRecursive
);
Parameter
[in] wszPath
Zeiger auf eine mit NULL beendete Breitzeichenzeichenfolge, die das Stammverzeichnis enthält, unter dem Dateien ausgeschlossen werden sollen.
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, darf aber keine Wildcardzeichen enthalten.
Es ist nicht erforderlich, dass der Pfad mit einem umgekehrten Schrägstrich ("") endet. Es ist an Anwendungen, die diese Informationen abrufen, um sie zu überprüfen.
[in] wszFilespec
Zeiger auf eine NULL-endende Breitzeichenzeichenfolge, die die Dateispezifikation der auszuschließenden Dateien enthält.
Eine Dateispezifikation kann keine Verzeichnisspezifikationen enthalten (z. B. keine umgekehrten Schrägstriche), sondern das ? und * Wildcardzeichen.
[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 Eine 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.
Rückgabewert
Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.
| Wert | Bedeutung |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Aufrufer verfügt über nicht genügend 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. |
|
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– Gruppen von Dateien, deren absoluter Pfad mit einer gültigen lokalen Volumespezifikation beginnt und kein zugeordnetes Netzlaufwerk sein kann. Daher müssen Pfadeingaben (wszPath) zu AddExcludeFiles (nach der Auflösung aller Umgebungsvariablen) dieses Format aufweisen.
Beispielsweise ist es oft praktisch, eine Komponente zu definieren, um alle Dateien in einem bestimmten Verzeichnis einzuschließen, und dann AddExcludeFiles zu verwenden, um einige Dateien (für instance temporäre Dateien) explizit aus einer Sicherung zu entfernen.
Weitere Informationen zum Ausschließen von Dateien finden Sie unter Spezifikation der Ausschlussdateiliste.
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 (enthalten Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |