IVssSoftwareSnapshotProvider::IsVolumeSnapshotted-Methode (vsprov.h)

Artikel
03/03/2024

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

Freigeben über