IVssDifferentialSoftwareSnapshotMgmt2::ChangeDiffAreaMaximumSizeEx-Methode (vsmgmt.h)

Artikel
08/27/2023

Updates die maximale Größe des Schattenkopiespeicherbereichs für ein bestimmtes Volume. Dies hat möglicherweise keine sofortige Wirkung. Wenn der bVolatile-ParameterFALSE ist, wird die Änderung auch dann fortgesetzt, wenn der Computer neu gestartet wird.

Syntax

HRESULT ChangeDiffAreaMaximumSizeEx(
  [in] VSS_PWSZ pwszVolumeName,
  [in] VSS_PWSZ pwszDiffAreaVolumeName,
  [in] LONGLONG llMaximumDiffSpace,
  [in] BOOL     bVolatile
);

Parameter

[in] pwszVolumeName

Der Name des Volumes, das die Quelle von Schattenkopien ist. Dieses Volume ist einem Schattenkopiespeicherbereich auf dem Volume pwszDiffAreaVolumeName zugeordnet.

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)

[in] pwszDiffAreaVolumeName

Der Name des Volumes, das den Schattenkopiespeicherbereich enthält, der dem PwszVolumeName-Volume zugeordnet ist.

Der Name des Volumes muss in einem der folgenden Formate vorliegen und einen nachfolgenden umgekehrten Schrägstrich (\) enthalten:

Der Pfad eines eingebundenen Ordners
Ein Laufwerkbuchstabe mit z. B. D:\
Ein Volume-GUID-Pfad im Format \\?\Volume{GUID}\ (wobei GUID das Volume identifiziert)

[in] llMaximumDiffSpace

Gibt die maximale Größe in Bytes für den Schattenkopiespeicherbereich an, der für das Volume verwendet werden soll. Wenn dieser Wert null ist, wird der Speicherbereich für Schattenkopien gelöscht. Wenn dieser Wert –1 ist, ist die maximale Größe unbegrenzt.

[in] bVolatile

TRUE, um anzugeben, dass der Effekt des Aufrufs der ChangeDiffAreaMaximumSizeEx-Methode nicht fortgesetzt werden sollte, wenn der Computer neu gestartet wird; andernfalls FALSE.

Der Standardwert ist FALSE.

Wenn der LlMaximumDiffSpace-Parameter null ist, muss der bVolatile-ParameterFALSE sein.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	Bedeutung
S_OK	Die maximale Größe des Schattenkopiespeicherbereichs wurde erfolgreich geändert.
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_INSUFFICIENT_STORAGE	Das Volume pwszDiffAreaVolumeName verfügt nicht über genügend freien Speicherplatz.
VSS_E_OBJECT_NOT_FOUND	Die Zuordnung zwischen den Volumes pwszVolumeName und pwszDiffAreaVolumeName wurde nicht gefunden.
VSS_E_PROVIDER_VETO	Ein erwarteter Anbieterfehler ist aufgetreten. Der Fehlercode wird 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.
VSS_E_VOLUME_IN_USE	Eine Schattenkopie verwendet derzeit den Speicherbereich für Schattenkopien.

Hinweise

Die ChangeDiffAreaMaximumSizeEx-Methode ist mit der IVssDifferentialSoftwareSnapshotMgmt::ChangeDiffAreaMaximumSize-Methode identisch, mit Ausnahme des bVolatile-Parameters .

Das Aufrufen der ChangeDiffAreaMaximumSizeEx-Methode mit dem bVolatile-Parameter , der auf FALSE festgelegt ist, entspricht dem Aufrufen der ChangeDiffAreaMaximumSize-Methode .

ChangeDiffAreaMaximumSizeEx macht den Schattenkopiespeicherbereich explizit, was bedeutet, dass er nicht automatisch gelöscht wird, wenn alle Schattenkopien gelöscht werden.

Wenn der Speicherbereich für Schattenkopien nicht vorhanden ist, wird er von dieser Methode erstellt.

Windows Server 2008, Windows Vista und Windows Server 2003: Wenn der Schattenkopiespeicherbereich nicht vorhanden ist, wird er von dieser Methode nicht erstellt.

Verwenden Sie zum Erstellen eines Schattenkopiespeicherbereichs die IVssDifferentialSoftwareSnapshotMgmt::AddDiffArea-Methode .

Anforderungen

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

Weitere Informationen

IVssDifferentialSoftwareSnapshotMgmt2

IVssDifferentialSoftwareSnapshotMgmt::ChangeDiffAreaMaximumSize

Freigeben über