IVssCreateWriterMetadataEx::AddExcludeFilesFromSnapshot-Methode (vswriter.h)
Meldet alle Dateisätze , die vom Writer explizit ausgeschlossen werden, wenn eine Schattenkopie erstellt wird.
Wenn Sie diese Methode aufrufen, werden die Dateien nicht ausgeschlossen. Der Writer ist für das Löschen der Dateien aus der Schattenkopie in seiner CVssWriter::OnPostSnapshot-Methode verantwortlich.
Syntax
HRESULT AddExcludeFilesFromSnapshot(
[in] LPCWSTR wszPath,
[in] LPCWSTR wszFilespec,
[in] bool bRecursive
);
Parameter
[in] wszPath
Ein Zeiger auf eine mit NULL endende 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, zu überprüfen, ob der Pfad mit einem umgekehrten Schrägstrich endet.
[in] wszFilespec
Ein Zeiger auf eine mit NULL beendete 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. |
|
Diese Methode wird für Express-Writer nicht unterstützt. |
|
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 unterstützt, wenn Windows 8 und Windows Server 2012.
Die Verwendung der AddExcludeFilesFromSnapshot-Methode ist optional. Writer sollten diese Methode nur für große Dateien verwenden, die sich zwischen Schattenkopievorgängen erheblich ändern.
Diese Methode ist kein Ersatz für die IVssCreateWriterMetadata::AddExcludeFiles-Methode . Writer sollten weiterhin die AddExcludeFiles-Methode verwenden, um zu melden, welche Dateisätze von der Sicherung ausgeschlossen sind.
Der Aufrufer ist für den Aufruf der IUnknown::Release-Methode verantwortlich, um die Ressourcen des zurückgegebenen IVssWMFiledesc-Objekts freizugeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vswriter.h (enthalten Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |
Weitere Informationen
IVssCreateWriterMetadata::AddExcludeFiles