Share via

IVssSoftwareSnapshotProvider::IsVolumeSnapshotted-Methode (vsprov.h)

  • Artikel

Bestimmt, ob Schattenkopien für das angegebene Volume vorhanden sind.

Syntax

HRESULT IsVolumeSnapshotted(
  [in]  VSS_PWSZ pwszVolumeName,
  [out] BOOL     *pbSnapshotsPresent,
  [out] LONG     *plSnapshotCompatibility
);

Parameter

[in] pwszVolumeName

Breite NULL-Zeichenfolge, die den Volumenamen enthält. Der Name 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 der Form \\?\Volume{GUID}\ (wobei GUID das Volume identifiziert)

[out] pbSnapshotsPresent

Dieser Parameter empfängt TRUE , wenn das Volume über eine Schattenkopie verfügt, oder FALSE , wenn das Volume keine Schattenkopie aufweist.

[out] plSnapshotCompatibility

Eine Bitmaske mit VSS_SNAPSHOT_COMPATIBILITY Werten, die angeben, ob bestimmte Volumesteuerungs- oder Datei-E/A-Vorgänge für das angegebene Volume deaktiviert sind, wenn das Volume eine Schattenkopie aufweist.

Rückgabewert

Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.

Wert Bedeutung
S_OK
 Die angeforderten Informationen wurden erfolgreich zurückgegeben.
E_ACCESSDENIED
 Der Aufrufer verfügt nicht über ausreichende Sicherungsberechtigungen oder ist kein Administrator.
E_INVALIDARG
 Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY
 Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen.
VSS_E_OBJECT_NOT_FOUND
 Das angegebene Volume wurde nicht gefunden.
VSS_E_PROVIDER_VETO
 Anbieterfehler. Der Anbieter hat den Fehler im Ereignisprotokoll protokolliert. 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

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, 0.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vsprov.h
Bibliothek VssApi.lib

Weitere Informationen

IVssSoftwareSnapshotProvider