IVssDifferentialSoftwareSnapshotMgmt3::D eleteUnusedDiffAreas-Methode (vsmgmt.h)
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 |
|---|---|
|
Die Speicherbereiche für Schattenkopien wurden erfolgreich gelöscht. |
|
Der Aufrufer ist kein Administrator. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Anbieter für das Volume unterstützt keinen Schattenkopienschutz. |
|
Ein erwarteter Anbieterfehler ist aufgetreten. Der Fehlercode wird im Ereignisprotokoll protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. |
|
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 |