Méthode IVssProviderCreateSnapshotSet::P ostFinalCommitSnapshots (vsprov.h)

Article
08/27/2023

La méthode PostFinalCommitSnapshots prend en charge la récupération automatique des clichés instantanés. VSS appelle cette méthode pour informer le fournisseur que le volume sera désormais en lecture seule jusqu’à ce qu’un demandeur appelle IVssBackupComponents::BreakSnapshotSet.

Syntaxe

HRESULT PostFinalCommitSnapshots(
  [in] VSS_ID SnapshotSetId
);

Paramètres

[in] SnapshotSetId

VSS_ID qui identifie le jeu de clichés instantanés.

Valeur retournée

Code/valeur de retour	Description
S_OK 0x000000000L	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_PROVIDER_VETO 0x80042306L	Une erreur de fournisseur inattendue s’est produite. Si cela est retourné, l’erreur doit être décrite dans une entrée dans le journal des événements de l’application, ce qui donne à l’utilisateur des informations sur la façon de résoudre le problème.

Si une autre valeur est retournée, VSS écrit un événement dans le journal des événements et convertit l’erreur en VSS_E_UNEXPECTED_PROVIDER_ERROR.

Remarques

Cette méthode a été ajoutée dans Windows Server 2003 pour activer la compatibilité binaire lorsque la fonctionnalité de récupération automatique a été introduite dans Windows Server 2003 avec Service Pack 1 (SP1).

Note Pour Windows Server 2003, il est recommandé que les fournisseurs de matériel implémentent cette méthode à l’aide de l’exemple suivant :

HRESULT PostFinalCommitSnapshots(
    VSS_ID     /* SnapshotSetId */
)
{
    return S_OK;
}

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008, Windows Server 2003 avec SP1 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	vsprov.h

Voir aussi

IVssProviderCreateSnapshotSet

Partager via