Méthode IVssHardwareSnapshotProvider ::BeginPrepareSnapshot (vsprov.h)

Article
08/27/2023

La méthode BeginPrepareSnapshot est appelée pour chaque cliché instantané ajouté au jeu de clichés instantanés.

Note Les fournisseurs de matériel sont pris en charge uniquement sur les systèmes d’exploitation Windows Server.

Syntaxe

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

Paramètres

[in] SnapshotSetId

Identificateur du jeu de clichés instantanés.

[in] SnapshotId

Identificateur du cliché instantané à créer.

[in] lContext

Contexte de cliché instantané pour le jeu de clichés instantanés actuel, tel qu’énuméré par _VSS_VOLUME_SNAPSHOT_ATTRIBUTES.

[in] lLunCount

Nombre de LUN contribuant à ce volume de cliché instantané.

[in] rgDeviceNames

Pointeur vers le tableau de pointeurs lLunCount vers des chaînes, chaque chaîne contenant le nom d’un numéro logique à copier en ombres.

[in, out] rgLunInformation

Pointeur vers le tableau de structures lLunCountVDS_LUN_INFORMATION , une pour chaque unité logique contribuant à ce volume de cliché instantané.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code/valeur de retour	Description
S_OK 0x00000000L	L’opération s’est terminée avec succès.
E_OUTOFMEMORY 0x8007000EL	Mémoire insuffisante ou autres ressources système.
E_INVALIDARG 0x80070057L	L’une des valeurs de paramètre n’est pas valide.
VSS_E_MAXIMUM_NUMBER_OF_VOLUMES_REACHED 0x80042312L	Le fournisseur a atteint le nombre maximal de volumes qu’il peut prendre en charge.
VSS_E_NESTED_VOLUME_LIMIT	Le volume spécifié est imbriqué trop profondément pour participer à l’opération VSS. Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Ce code de retour n’est pas pris en charge.
VSS_E_PROVIDER_VETO 0x80042306L	Une erreur de fournisseur inattendue s’est produite. Le fournisseur doit signaler un événement dans le journal des événements de l’application en fournissant à l’utilisateur des informations sur la façon de résoudre le problème.
VSS_E_VOLUME_NOT_SUPPORTED_BY_PROVIDER 0x8004230EL	Le fournisseur ne prend pas en charge ce volume.
VSS_E_UNSUPPORTED_CONTEXT 0x8004231BL	Le contexte spécifié par lContext n’est pas pris en charge.

Remarques

Cette méthode ne peut pas être appelée pour un disque dur virtuel imbriqué dans un autre disque dur virtuel.

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Les disques durs virtuels ne sont pas pris en charge.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	vsprov.h

Voir aussi

IVssHardwareSnapshotProvider

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES

Partager via