IVssExamineWriterMetadataEx2::GetExcludeFromSnapshotFile-Methode (vsbackup.h)
Ruft Informationen zu Dateisätzen ab , die explizit aus einer bestimmten Schattenkopie ausgeschlossen wurden.
Syntax
HRESULT GetExcludeFromSnapshotFile(
[in] UINT iFile,
[out] IVssWMFiledesc **ppFiledesc
);
Parameter
[in] iFile
Ein Index für einen ausgeschlossenen Dateisatz. Der Wert dieses Parameters ist eine ganze Zahl von 0 bis einschließlich n–1, wobei n die Gesamtzahl der Dateisätze ist, die explizit aus einer bestimmten Schattenkopie ausgeschlossen werden. Der Wert von n wird von der IVssExamineWriterMetadataEx2::GetExcludeFromSnapshotCount-Methode zurückgegeben.
[out] ppFiledesc
Ein doppelt indirekter Zeiger auf ein IVssWMFiledesc-Objekt , das die Dateielementinformationen enthält.
Rückgabewert
Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.
| Wert | Bedeutung |
|---|---|
|
Der Zeiger auf eine IVssWMFiledesc-Schnittstelle wurde erfolgreich zurückgegeben. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen. |
|
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
Der Aufrufer ist für den Aufruf der IUnknown::Release-Methode verantwortlich, um die Ressourcen des zurückgegebenen IVssWMFiledesc-Objekts freizugeben.
Die GetExcludeFromSnapshotFile-Methode dient zum Melden von Informationen zu Dateisätzen, die von einer Schattenkopie ausgeschlossen sind. Anforderer sollten Dateien basierend auf den von dieser Methode zurückgegebenen Informationen nicht von der Sicherung ausschließen.
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 | vsbackup.h (enthalten VsBackup.h, Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |