Méthode IVssCreateExpressWriterMetadata ::SetRestoreMethod (vswriter.h)

Article
08/27/2023

Spécifie la façon dont les données d’un writer express doivent être restaurées.

Syntaxe

HRESULT SetRestoreMethod(
  [in] VSS_RESTOREMETHOD_ENUM method,
  [in] LPCWSTR                wszService,
  [in] LPCWSTR                wszUserProcedure,
  [in] VSS_WRITERRESTORE_ENUM writerRestore,
  [in] bool                   bRebootRequired
);

Paramètres

[in] method

Valeur d’énumération VSS_RESTOREMETHOD_ENUM spécifiant la méthode de restauration à utiliser dans l’opération de restauration. Ce paramètre est obligatoire et ne peut pas être VSS_RME_UNDEFINED, VSS_RME_RESTORE_TO_ALTERNATE_LOCATION ou VSS_RME_CUSTOM.

[in] wszService

Pointeur vers une chaîne de caractères large contenant le nom d’un service qui doit être arrêté avant une opération de restauration, puis démarré après l’opération de restauration, si la valeur de la méthode est VSS_RME_STOP_RESTORE_START ou VSS_RME_RESTORE_STOP_START.

Si la valeur de la méthode n’est pas VSS_RME_STOP_RESTORE_START ou VSS_RME_RESTORE_STOP_START, ce paramètre n’est pas utilisé et doit être défini sur NULL.

[in] wszUserProcedure

Réservé pour un usage futur. La valeur de ce paramètre doit toujours être définie sur NULL.

[in] writerRestore

Valeur d’énumération VSS_WRITERRESTORE_ENUM spécifiant si l’enregistreur sera impliqué dans la restauration de ses données. Ce paramètre doit être défini sur VSS_WRE_NEVER.

[in] bRebootRequired

Valeur booléenne indiquant si un redémarrage sera nécessaire une fois l’opération de restauration terminée.

Valeur retournée

Voici les codes de retour valides pour cette méthode.

Valeur	Signification
S_OK	L'opération a réussi.
E_INVALIDARG	L’une des valeurs de paramètre n’est pas valide.
E_OUTOFMEMORY	L’appelant n’a plus de mémoire ou d’autres ressources système.
VSS_E_INVALID_XML_DOCUMENT	Le document XML n’est pas valide. Pour plus d’informations, consultez le journal des événements. Pour plus d’informations, consultez Gestion des événements et des erreurs sous VSS.
VSS_E_UNEXPECTED	Erreur inattendue. Le code d’erreur est enregistré dans le fichier journal des erreurs. Pour plus d’informations, consultez Gestion des événements et des erreurs sous VSS. Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Cette valeur n’est pas prise en charge tant que Windows Server 2008 R2 et Windows 7. E_UNEXPECTED est utilisé à la place.

Remarques

Un enregistreur express ne peut définir qu’une seule méthode de restauration. Si la méthode de restauration n’est pas remplacée, tous les composants de l’enregistreur express sont restaurés à l’aide de la même méthode.

Les enregistreurs express remplacent la méthode de restauration sur une base de composant par composant en définissant une cible de restauration, généralement lors de la gestion d’un événement PreRestore (CVssWriter ::OnPreRestore).

Il est important de noter que malgré le fait que les méthodes de restauration sont appliquées par enregistreur, les méthodes sont implémentées par composant. Par exemple, si la méthode spécifiée par le paramètre de méthode est VSS_RME_RESTORE_IF_CAN_REPLACE, tous les fichiers du composant sont restaurés à leur emplacement d’origine s’ils peuvent tous être remplacés sans qu’une erreur ne se produise. Dans le cas contraire, ils sont restaurés à leur autre emplacement, le cas échéant.

Un fichier peut être restauré dans un autre mappage d’emplacement si l’une des conditions suivantes est remplie :

La méthode de restauration est VSS_RME_RESTORE_IF_NOT_THERE et une version du fichier est déjà présente sur le disque.
La méthode de restauration est VSS_RME_RESTORE_IF_CAN_REPLACE et une version du fichier est présente sur le disque et ne peut pas être remplacée.

Si aucun mappage d’emplacement secondaire valide n’est défini, il s’agit d’une erreur de writer.

Pour plus d’informations sur les méthodes de restauration, consultez Définition des méthodes de restauration VSS.

Si la méthode de restauration est VSS_RME_STOP_RESTORE_START ou VSS_RME_RESTORE_STOP_START, le nom correct du service doit être fourni en tant qu’argument wszService . Pour plus d’informations sur la participation de l’enregistreur à l’arrêt et au redémarrage des services pendant une opération de restauration, consultez Arrêt des services pour la restauration par les demandeurs.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	vswriter.h (inclure Vss.h, VsWriter.h)
Bibliothèque	VssApi.lib

Voir aussi

IVssCreateExpressWriterMetadata

Partager via