Share via

IVssDifferentialSoftwareSnapshotMgmt::QueryDiffAreasForVolume-Methode (vsmgmt.h)

  • Artikel

Die QueryDiffAreasForVolume-Methode fragt Schattenkopie-Speicherbereiche ab, die vom Volume verwendet werden.

Syntax

HRESULT QueryDiffAreasForVolume(
  [in]  VSS_PWSZ           pwszVolumeName,
  [out] IVssEnumMgmtObject **ppEnum
);

Parameter

[in] pwszVolumeName

Name des Volumes, das Schattenkopie-Speicherbereiche enthält.

Der Name des 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 im Format \\?\Volume{GUID}\ (wobei GUID das Volume identifiziert)

[out] ppEnum

Die Adresse eines IVssEnumMgmtObject-Schnittstellenzeigers , der bei der Rückgabe initialisiert wird. Aufrufer müssen die Schnittstelle freigeben.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert Bedeutung
S_OK
 Die Speicherbereiche für Schattenkopien wurden erfolgreich abgefragt.
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 über nicht genügend Arbeitsspeicher oder andere Systemressourcen.
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

Das zurückgegebene IVssEnumMgmtObject-Enumeratorobjekt enthält VSS_DIFF_AREA_PROP Strukturen innerhalb der VSS_MGMT_OBJECT_UNION Union innerhalb der VSS_MGMT_OBJECT_PROP-Struktur .

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 vsmgmt.h

Weitere Informationen

IVssDifferentialSoftwareSnapshotMgmt

IVssEnumMgmtObject