Freigeben über

IVssHardwareSnapshotProvider::BeginPrepareSnapshot-Methode (vsprov.h)

Die BeginPrepareSnapshot-Methode wird für jede Schattenkopie aufgerufen, die dem Schattenkopiensatz hinzugefügt wird.

Anmerkung Hardwareanbieter werden nur unter Windows Server-Betriebssystemen unterstützt.
 

Syntax

HRESULT BeginPrepareSnapshot(
  [in]      VSS_ID              SnapshotSetId,
  [in]      VSS_ID              SnapshotId,
  [in]      LONG                lContext,
  [in]      LONG                lLunCount,
  [in]      VSS_PWSZ            *rgDeviceNames,
  [in, out] VDS_LUN_INFORMATION *rgLunInformation
);

Die Parameter

[in] SnapshotSetId

Bezeichner des Schattenkopie-Satzes.

[in] SnapshotId

Bezeichner der zu erstellenden Schattenkopie.

[in] lContext

Schattenkopiekontext für den aktuellen Schattenkopie-Satz, der durch _VSS_VOLUME_SNAPSHOT_ATTRIBUTES aufgezählt wird.

[in] lLunCount

Anzahl der LUNs, die zu diesem Schattenkopie-Volume beitragen.

[in] rgDeviceNames

Zeiger auf ein Array von lLunCount-Zeigern auf Zeichenfolgen, jede Zeichenfolge, die den Namen eines LUN enthält, deren Schatten kopiert werden soll.

[in, out] rgLunInformation

Zeiger auf array von lLunCountVDS_LUN_INFORMATION Strukturen, eines für jedes LUN, das zu diesem Schattenkopie-Volume beiträgt.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Zurückgeben von Code/Wert Description
S_OK
0x000000000L
 Der Vorgang wurde erfolgreich abgeschlossen.
E_OUTOFMEMORY
0x8007000EL
 Nicht genügend Arbeitsspeicher oder andere Systemressourcen.
E_INVALIDARG
0x80070057L
 Einer der Parameterwerte ist ungültig.
VSS_E_MAXIMUM_NUMBER_OF_VOLUMES_REACHED
0x80042312L
 Der Anbieter hat die maximale Anzahl von Volumes erreicht, die er unterstützen kann.
VSS_E_NESTED_VOLUME_LIMIT
 Das angegebene Volume ist zu tief geschachtelt, um an der VSS-Operation teilzunehmen.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Rückgabecode wird nicht unterstützt.
VSS_E_PROVIDER_VETO
0x80042306L
 Unerwarteter Anbieterfehler. Der Anbieter muss ein Ereignis im Anwendungsereignisprotokoll melden, das dem Benutzer Informationen zum Beheben des Problems liefert.
VSS_E_VOLUME_NOT_SUPPORTED_BY_PROVIDER
0x8004230EL
 Dieses Volume wird vom Anbieter nicht unterstützt.
VSS_E_UNSUPPORTED_CONTEXT
0x8004231BL
 Der durch lContext angegebene Kontext wird nicht unterstützt.

Bemerkungen

Diese Methode kann nicht für eine virtuelle Festplatte (VHD) aufgerufen werden, die in einer anderen VHD geschachtelt ist.

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

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Nicht unterstützt
Mindestanforderungen für unterstützte Server Windows Server 2003 [Nur Desktop-Apps]
Zielplattform Fenster
Header vsprov.h

Siehe auch

IVssHardwareSnapshotProvider

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES

  • Last updated on