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 IsVolumeSnapshotted-Funktion bestimmt, ob Schattenkopien für das angegebene Volume vorhanden sind.
Hinweis Diese Funktion wird als IsVolumeSnapshottedInternal exportiert. Sie sollten jedoch IsVolumeSnapshotted und nicht IsVolumeSnapshottedInternal aufrufen.
Syntax
HRESULT IsVolumeSnapshottedInternal(
[in] VSS_PWSZ pwszVolumeName,
[out] BOOL *pbSnapshotsPresent,
[out] LONG *plSnapshotCapability
);
Parameter
[in] pwszVolumeName
Name des Volumes. Der Name des zu überprüfenden Volumes muss in einem der folgenden Formate vorliegen und einen nachfolgenden umgekehrten Schrägstrich (\) enthalten:
- Der Pfad eines eingebundenen Ordners, z. B. Y:\MountX\
- Ein Laufwerkbuchstabe, z. B. D:\
- Ein Volume-GUID-Pfad im Format \\?\Volume{GUID}\ (wobei GUID das Volume identifiziert)
[out] pbSnapshotsPresent
Der Wert dieses Parameters ist TRUE , wenn das Volume über eine Schattenkopie verfügt, und FALSE , wenn das Volume keine Schattenkopie aufweist.
[out] plSnapshotCapability
Eine Bitmaske (oder bitweise OR) mit VSS_SNAPSHOT_COMPATIBILITY Werten, die angibt, ob bestimmte Volumesteuerungs- oder Datei-E/A-Vorgänge für das angegebene Volume deaktiviert sind, wenn eine Schattenkopie davon vorhanden ist.
Rückgabewert
Die hier aufgeführten Rückgabewerte sind zusätzlich zu den normalen COM HRESULT-Werten, die jederzeit von der Funktion zurückgegeben werden können.
| Wert | Bedeutung |
|---|---|
|
Die Funktion wurde erfolgreich abgeschlossen. |
|
Der Aufrufer verfügt nicht über ausreichende Sicherungsberechtigungen oder ist kein Administrator. |
|
Einer der Parameter ist ungültig. |
|
Nicht genügend Arbeitsspeicher oder andere Systemressourcen. |
|
Erwarteter Anbieterfehler. Der Anbieter hat den Fehler im Ereignisprotokoll protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. |
|
Das angegebene Volume wurde nicht gefunden. |
|
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. |
|
Unerwarteter Anbieterfehler. Der Fehlercode wird in der Ereignisprotokolldatei protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. |
Hinweise
Vor dem Aufrufen dieser Funktion muss der Aufrufer COM durch Aufrufen der CoInitialize-Funktion initialisiert haben.
Wenn keine Volumesteuerung oder Datei-E/A-Vorgänge für das ausgewählte Volume deaktiviert sind, ist die Schattenkopiefunktion des ausgewählten Volumes, das von plSnapshotCapability zurückgegeben wird, null.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vsbackup.h (enthalten VsBackup.h, Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |
| DLL | VssApi.dll |