IVssSoftwareSnapshotProvider::IsVolumeSupported-Methode (vsprov.h)

Artikel
08/27/2023

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

Freigeben über