Freigeben über

IVssDifferentialSoftwareSnapshotMgmt::AddDiffArea-Methode (vsmgmt.h)

  • Artikel

Die AddDiffArea-Methode fügt eine Schattenkopie-Speicherbereichszuordnung für das angegebene Volume hinzu. Wenn die Zuordnung nicht unterstützt wird, wird ein Fehlercode zurückgegeben.

Syntax

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

Parameter

[in] pwszVolumeName

Der Name des Volumes, das die Quelle von Schattenkopien sein soll. 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

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

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

Die maximale Größe des Schattenkopiespeicherbereichs auf dem Volume in Bytes. Dieser Wert muss mindestens 320 MB bis zum systemweiten Grenzwert betragen. Wenn dieser Wert –1 ist, ist die maximale Größe unbegrenzt.

Windows Server 2003: Vor Windows Server 2003 mit SP1 wurde die Größe des Schattenkopiespeicherbereichs auf 100 MB festgelegt.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert Bedeutung
S_OK
 Die Zuordnung des Schattenkopiespeicherbereichs wurde erfolgreich hinzugefügt.
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_MAXIMUM_DIFFAREA_ASSOCIATIONS_REACHED
 Die maximale Anzahl von Schattenkopiespeicherbereichen wurde dem Quellvolume für Schattenkopien hinzugefügt. Das angegebene Schattenkopie-Speichervolume war dem angegebenen Schattenkopie-Quellvolume nicht zugeordnet.
VSS_E_NESTED_VOLUME_LIMIT
 Das angegebene Volume ist zu tief geschachtelt, um am VSS-Vorgang teilzunehmen.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Rückgabecode wird nicht unterstützt.
VSS_E_OBJECT_ALREADY_EXISTS
 Die Zuordnung zwischen den Volumes pwszVolumeName und pwszDiffAreaVolumeName ist bereits vorhanden.
VSS_E_PROVIDER_VETO
 Erwarteter 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_NOT_SUPPORTED
 Das PwszDiffAreaVolumeName-Volume ist kein NTFS-Volume oder verfügt über nicht genügend freien Speicherplatz.

Hinweise

Eine Zuordnung des Schattenkopiespeicherbereichs kann nicht erstellt werden, wenn bereits Schattenkopien für das pwszVolumeName-Volume vorhanden sind oder wenn für dieses Volume bereits eine Schattenkopiespeicherbereichszuordnung vorhanden ist.

Der Schattenkopiespeicherbereich für ein VHD-Quellvolume muss sich auf demselben Volume befinden. Ebenso kann ein Schattenkopiespeicherbereich nur auf einem VHD-Volume erstellt werden, wenn das Quellvolume für beide Volumes identisch ist.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: VHDs werden nicht unterstützt.

Um die Größe eines Schattenkopiespeicherbereichs zu ändern, verwenden Sie die IVssDifferentialSoftwareSnapshotMgmt::ChangeDiffAreaMaximumSize or IVssDifferentialSoftwareSnapshotMgmt2::ChangeDiffAreaMaximumSizeEx-Methode . Sie können einen Schattenkopiespeicherbereich löschen, indem Sie seine Größe auf Null ändern.

Anforderungen

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

Weitere Informationen

IVssDifferentialSoftwareSnapshotMgmt