Metodo IVssHardwareSnapshotProvider::BeginPrepareSnapshot (vsprov.h)

Articolo
03/03/2024

Il metodo BeginPrepareSnapshot viene chiamato per ogni copia shadow aggiunta al set di copia shadow.

Nota I provider hardware sono supportati solo nei sistemi operativi Windows Server.

Sintassi

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

Parametri

[in] SnapshotSetId

Identificatore del set di copia shadow.

[in] SnapshotId

Identificatore della copia shadow da creare.

[in] lContext

Contesto di copia shadow per il set di copia shadow corrente come enumerato da _VSS_VOLUME_SNAPSHOT_ATTRIBUTES.

[in] lLunCount

Numero di LUN che contribuiscono a questo volume di copia shadow.

[in] rgDeviceNames

Puntatore alla matrice di puntatori lLunCount alle stringhe, ogni stringa contenente il nome di un LUN da copiare.

[in, out] rgLunInformation

Puntatore alla matrice di strutture VDS_LUN_INFORMATION lLunCount, una per ogni LUN che contribuisce a questo volume di copia shadow.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice/valore restituito	Descrizione
S_OK 0x00000000L	L'operazione è stata completata correttamente.
E_OUTOFMEMORY 0x8007000EL	Memoria insufficiente o altre risorse di sistema.
E_INVALIDARG 0x80070057L	Uno dei valori dei parametri non è valido.
VSS_E_MAXIMUM_NUMBER_OF_VOLUMES_REACHED 0x80042312L	Il provider ha raggiunto il numero massimo di volumi che può supportare.
VSS_E_NESTED_VOLUME_LIMIT	Il volume specificato è annidato troppo profondamente per partecipare all'operazione VSS. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo codice restituito non è supportato.
VSS_E_PROVIDER_VETO 0x80042306L	Si è verificato un errore del provider imprevisto. Il provider deve segnalare un evento nel registro eventi dell'applicazione che fornisce all'utente informazioni su come risolvere il problema.
VSS_E_VOLUME_NOT_SUPPORTED_BY_PROVIDER 0x8004230EL	Il provider non supporta questo volume.
VSS_E_UNSUPPORTED_CONTEXT 0x8004231BL	Il contesto specificato da lContext non è supportato.

Commenti

Questo metodo non può essere chiamato per un disco rigido virtuale (VHD) annidato all'interno di un altro disco rigido virtuale.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: I dischi rigidi virtuali non sono supportati.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vsprov.h

Vedi anche

IVssHardwareSnapshotProvider

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES

Condividi tramite