Freigeben über

IVssDifferentialSoftwareSnapshotMgmt::ChangeDiffAreaMaximumSize-Methode (vsmgmt.h)

  • Artikel

Die ChangeDiffAreaMaximumSize-Methode aktualisiert die maximale Größe des Schattenkopiespeicherbereichs für ein bestimmtes Volume. Dies hat möglicherweise keine sofortige Wirkung.

Syntax

HRESULT ChangeDiffAreaMaximumSize(
  [in] VSS_PWSZ pwszVolumeName,
  [in] VSS_PWSZ pwszDiffAreaVolumeName,
  [in] LONGLONG llMaximumDiffSpace
);

Parameter

[in] pwszVolumeName

Name des Volumes, das die Quelle von Schattenkopien ist. Dieses Volume ist einem Schattenkopiespeicherbereich auf dem PwszDiffAreaVolumeName-Volume 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 der Form \\?\Volume{GUID}\ (wobei GUID das Volume identifiziert)

[in] pwszDiffAreaVolumeName

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, z. B. D:\
  • Ein Volume-GUID-Pfad der Form \\?\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 0 ist, wird der Speicherbereich für Schattenkopien gelöscht. Wenn dieser Wert –1 ist, ist die maximale Größe unbegrenzt.

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 nicht über Arbeitsspeicher oder andere Systemressourcen.
VSS_E_INSUFFICIENT_STORAGE
 Das PwszDiffAreaVolumeName-Volume 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
 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.
VSS_E_VOLUME_IN_USE
 Eine Schattenkopie verwendet derzeit den Speicherbereich für Schattenkopien.

Hinweise

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

Wenn der Schattenkopiespeicherbereich 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 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vsmgmt.h

Weitere Informationen

IVssDifferentialSoftwareSnapshotMgmt