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

Article
08/27/2023

La méthode PreFinalCommitSnapshots permet aux fournisseurs de prendre en charge la récupération automatique des clichés instantanés. Si le cliché instantané a l’indicateur VSS_VOLSNAP_ATTR_AUTORECOVER défini dans le contexte, le volume peut recevoir un grand nombre d’écritures pendant l’opération de récupération automatique.

Syntaxe

HRESULT PreFinalCommitSnapshots(
  [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 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_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 pour activer la compatibilité binaire lors de l’introduction de la fonctionnalité de récupération automatique 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 PreFinalCommitSnapshots(
VSS_ID     /* SnapshotSetId */
)
{
    return S_OK;
}

Configuration requise

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

Voir aussi

IVssProviderCreateSnapshotSet

Partager via