IsVolumeSnapshotted-Funktion (vsbackup.h)

Artikel
08/27/2023

Die IsVolumeSnapshotted-Funktion bestimmt, ob Schattenkopien für das angegebene Volume vorhanden sind.

Hinweis Diese Funktion wird als IsVolumeSnapshottedInternal exportiert. Sie sollten jedoch IsVolumeSnapshotted und nicht IsVolumeSnapshottedInternal aufrufen.

Syntax

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

Parameter

[in] pwszVolumeName

Name des Volumes. Der Name des zu überprüfenden Volumes 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

Der Wert dieses Parameters ist TRUE , wenn das Volume über eine Schattenkopie verfügt, und FALSE , wenn das Volume keine Schattenkopie aufweist.

[out] plSnapshotCapability

Eine Bitmaske (oder bitweise OR) von VSS_SNAPSHOT_COMPATIBILITY Werten, die angibt, ob bestimmte Volumesteuerungs- oder Datei-E/A-Vorgänge für das angegebene Volume deaktiviert sind, wenn eine Schattenkopie davon vorhanden ist.

Rückgabewert

Die hier aufgeführten Rückgabewerte sind zusätzlich zu den normalen COM-HRESULT-Werten, die jederzeit von der Funktion zurückgegeben werden können.

Wert	Bedeutung
S_OK	Die Funktion wurde erfolgreich abgeschlossen.
E_ACCESSDENIED	Der Aufrufer verfügt nicht über ausreichende Sicherungsberechtigungen oder ist kein Administrator.
E_INVALIDARG	Einer der Parameter ist ungültig.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher oder andere Systemressourcen.
VSS_E_PROVIDER_VETO	Erwarteter Anbieterfehler. Der Anbieter hat den Fehler im Ereignisprotokoll protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS.
VSS_E_OBJECT_NOT_FOUND	Das angegebene Volume wurde nicht gefunden.
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.
VSS_E_UNEXPECTED_PROVIDER_ERROR	Unerwarteter Anbieterfehler. Der Fehlercode wird in der Ereignisprotokolldatei protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS.

Hinweise

Vor dem Aufrufen dieser Funktion muss der Aufrufer COM initialisiert haben, indem er die CoInitialize-Funktion aufruft .

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 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
DLL	VssApi.dll

Weitere Informationen

VSS_SNAPSHOT_COMPATIBILITY

Freigeben über