Freigeben über

IVssDifferentialSoftwareSnapshotMgmt3::D eleteUnusedDiffAreas-Methode (vsmgmt.h)

  • Artikel

Löscht alle Schattenkopiespeicherbereiche (auch als diff Bereiche bezeichnet) auf dem angegebenen Volume, die nicht verwendet werden.

Syntax

HRESULT DeleteUnusedDiffAreas(
  [in] VSS_PWSZ pwszDiffAreaVolumeName
);

Parameter

[in] pwszDiffAreaVolumeName

Der Name des Volumes. Dieser Parameter ist erforderlich und darf nicht NULL sein.

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)

Rückgabewert

Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.

Wert Bedeutung
S_OK
 Die Speicherbereiche für Schattenkopien wurden erfolgreich gelöscht.
E_ACCESSDENIED
0x80070005L
 Der Aufrufer ist kein Administrator.
E_INVALIDARG
0x80070057L
 Einer der Parameterwerte ist ungültig.
E_NOTIMPL
0x800000001L
 Der Anbieter für das Volume unterstützt keinen Schattenkopienschutz.
VSS_E_PROVIDER_VETO
0x80042306L
 Ein erwarteter Anbieterfehler ist aufgetreten. Der Fehlercode wird im Ereignisprotokoll protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS.
VSS_E_OBJECT_NOT_FOUND
0x80042308L
 Das angegebene Volume wurde nicht gefunden.

Hinweise

Nicht verwendete Speicherbereichsdateien für Schattenkopien werden auf Speicherbereichsvolumes gefunden, wenn das zugeordnete Originalvolume aufgrund eines Schutzfehlers offline ist. In bestimmten Fällen kann das ursprüngliche Volume dauerhaft verloren gehen, und der Aufruf der DeleteUnusedDiffAreas-Methode ist die einzige Möglichkeit, den verlassenen Speicherplatz im Speicherbereich wiederherzustellen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Nicht unterstützt
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vsmgmt.h

Weitere Informationen

IVssDifferentialSoftwareSnapshotMgmt3