IVssBackupComponents::IsVolumeSupported-Methode (vsbackup.h)

Artikel
08/27/2023

Die IsVolumeSupported-Methode bestimmt, ob der angegebene Anbieter Schattenkopien auf dem angegebenen Volume oder der angegebenen Remotedateifreigabe unterstützt.

Syntax

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

Parameter

[in] ProviderId

Anbieterbezeichner. Wenn der Wert GUID_NULL ist, überprüft IsVolumeSupported , ob ein Anbieter das Volume oder die Remotedateifreigabe unterstützt.

[in] pwszVolumeName

Volumename oder UNC-Pfad der Remotedateifreigabe. Der Name oder UNC-Pfad 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)
Ein UNC-Pfad, der eine Remotedateifreigabe angibt, z. B. \\Clusterx\Share1\

[out] pbSupportedByThisProvider

Adresse einer vom Aufrufer zugewiesenen Variablen, die TRUE empfängt, wenn Schattenkopien auf dem angegebenen Volume oder auf der angegebenen Remotedateifreigabe unterstützt werden, oder andernfalls FALSE .

Rückgabewert

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

Wert	Bedeutung
S_OK	Die Supportinformationen des Anbieters wurden erfolgreich zurückgegeben.
E_ACCESSDENIED	Der Aufrufer verfügt nicht über ausreichende Sicherungsberechtigungen oder ist kein Administrator.
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 nicht über Arbeitsspeicher oder andere Systemressourcen.
VSS_E_BAD_STATE	Das Sicherungskomponentenobjekt wird nicht initialisiert, diese Methode wurde während eines Wiederherstellungsvorgangs aufgerufen, oder diese Methode wurde nicht in der richtigen Sequenz aufgerufen.
VSS_E_OBJECT_NOT_FOUND	Das angegebene Volume oder die angegebene Remotedateifreigabe wurde nicht gefunden oder war nicht verfügbar.
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

Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP und Windows Server 2003: Remotedateifreigaben werden erst unterstützt, wenn Windows 8 und Windows Server 2012.

IsVolumeSupported 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.

Hinweis Weitere Informationen zur maximalen Anzahl von Schattenkopien, die auf einem Volume erstellt werden können, finden Sie im Eintrag für MaxShadowCopies unter Registrierungsschlüssel und Werte für Sicherung und Wiederherstellung.

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

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 (einschließlich VsBackup.h, Vss.h, VsWriter.h)
Bibliothek	VssApi.lib

Weitere Informationen

IVssBackupComponents

IVssBackupComponents::AddToSnapshotSet

Freigeben über