IVssHardwareSnapshotProvider::BeginPrepareSnapshot-Methode (vsprov.h)

Artikel
03/03/2024

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

Hinweis 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
);

Parameter

[in] SnapshotSetId

Bezeichner des Schattenkopiersatzes.

[in] SnapshotId

Bezeichner der zu erstellenden Schattenkopie.

[in] lContext

Schattenkopiekontext für den aktuellen Schattenkopiersatz, der von _VSS_VOLUME_SNAPSHOT_ATTRIBUTES aufgezählt wird.

[in] lLunCount

Anzahl der LUNs, die zu diesem Schattenkopievolume beitragen.

[in] rgDeviceNames

Zeiger auf ein Array von lLunCount-Zeigern auf Zeichenfolgen , wobei jede Zeichenfolge den Namen einer LUN enthält, die schattenkopiert werden soll.

[in, out] rgLunInformation

Zeiger auf ein Array von lLunCountVDS_LUN_INFORMATION Strukturen, eine für jede LUN, die zu diesem Schattenkopievolume beiträgt.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode/-wert	BESCHREIBUNG
S_OK 0x00000000L	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 am VSS-Vorgang teilzunehmen. Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Rückgabecode wird nicht unterstützt.
VSS_E_PROVIDER_VETO 0x80042306L	Ein unerwarteter Anbieterfehler ist aufgetreten. Der Anbieter muss ein Ereignis im Anwendungsereignisprotokoll melden und dem Benutzer Informationen zum Beheben des Problems bereitstellen.
VSS_E_VOLUME_NOT_SUPPORTED_BY_PROVIDER 0x8004230EL	Der Anbieter unterstützt dieses Volume nicht.
VSS_E_UNSUPPORTED_CONTEXT 0x8004231BL	Der von lContext angegebene Kontext wird nicht unterstützt.

Hinweise

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
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	vsprov.h

Weitere Informationen

IVssHardwareSnapshotProvider

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES

Freigeben über