Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die GetExcludeFile-Methode ruft Informationen zu Dateien ab, die für einen bestimmten Writer explizit aus der Sicherung ausgeschlossen wurden.
Syntax
HRESULT GetExcludeFile(
[in] UINT iFile,
[out] IVssWMFiledesc **ppFiledesc
);
Parameter
[in] iFile
Index für einen ausgeschlossenen Dateisatz. Der Wert dieses Parameters ist eine ganze Zahl von 0 bis einschließlich n–1, wobei n die Gesamtanzahl der Dateisätze ist, die explizit aus den Komponenten eines bestimmten Writers ausgeschlossen sind. Der Wert von n wird von IVssExamineWriterMetadata::GetFileCounts zurückgegeben.
[out] ppFiledesc
Doppelt indirekter Zeiger auf ein IVssWMFiledesc-Objekt , das die Dateielementinformationen enthält.
Rückgabewert
Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.
| Wert | Bedeutung |
|---|---|
|
Erfolgreich einen Zeiger auf eine IVssWMFiledesc-Schnittstelle zurückgegeben. |
|
Einer der Parameterwerte ist ungültig. |
|
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. |
|
Der für den Ausschluss angegebene Dateisatz 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. |
Hinweise
Weitere Informationen zum Ausschließen von Dateien finden Sie unter Spezifikation der Ausschlussdateiliste.
Der Aufrufer ist für den Aufruf von IUnknown::Release verantwortlich, um die Ressourcen des zurückgegebenen IVssWMFiledesc-Objekts freizugeben.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vsbackup.h (einschließlich VsBackup.h, Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |