IVssCreateWriterMetadata::AddExcludeFiles-Methode (vswriter.h)

  • Artikel

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
S_OK
 Der Vorgang wurde durchgeführt.
E_INVALIDARG
 Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY
 Der Aufrufer verfügt über nicht genügend 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_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– 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

Weitere Informationen

IVssCreateWriterMetadata

IVssCreateWriterMetadata::AddComponent