Share via

IVssSoftwareSnapshotProvider::IsVolumeSupported-Methode (vsprov.h)

  • Artikel

Bestimmt, ob der Anbieter Schattenkopien auf dem angegebenen Volume unterstützt.

Syntax

HRESULT IsVolumeSupported(
  [in]  VSS_PWSZ pwszVolumeName,
  [out] BOOL     *pbSupportedByThisProvider
);

Parameter

[in] pwszVolumeName

Breitzeichenzeichenfolge mit NULL-Beendigung, 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 im Format \\?\Volume{GUID}\ (wobei GUID das Volume identifiziert)

[out] pbSupportedByThisProvider

Dieser Parameter empfängt TRUE , wenn Schattenkopien auf dem angegebenen Volume unterstützt werden, andernfalls FALSE.

Rückgabewert

Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.

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.
VSS_E_NESTED_VOLUME_LIMIT
 Das angegebene Volume ist zu tief geschachtelt, um am VSS-Vorgang teilzunehmen.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Rückgabecode wird nicht unterstützt.
E_OUTOFMEMORY
 Der Aufrufer verfügt über nicht genügend 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

Die IsVolumeSupported-Methode gibt TRUE zurück, wenn es möglich ist, Schattenkopien auf dem angegebenen Volume zu erstellen, auch wenn die aktuelle Konfiguration die Erstellung von Schattenkopien auf diesem Volume derzeit nicht zulässt.

Wenn beispielsweise die maximale Anzahl von Schattenkopien auf einem bestimmten Volume erreicht wurde (und daher auf diesem Volume keine Schattenkopien mehr erstellt werden können), gibt die -Methode weiterhin an, dass das Volume schattenkopiert werden kann.

Diese Methode kann nicht für eine virtuelle Festplatte (VHD) aufgerufen werden, die in einer anderen VHD geschachtelt ist.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: VHDs werden nicht unterstützt.

Anforderungen

   
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