Partager via

IVssBackupComponents ::QueryRevertStatus, méthode (vsbackup.h)

La méthode QueryRevertStatus retourne un pointeur d’interface IVssAsync qui peut être utilisé pour déterminer l’état de l’opération de restauration.

Syntaxe

HRESULT QueryRevertStatus(
  [in]  VSS_PWSZ  pwszVolume,
  [out] IVssAsync **ppAsync
);

Paramètres

[in] pwszVolume

Chaîne de caractères large terminée par null contenant le nom du volume. Le nom doit se trouver dans l’un des formats suivants et doit inclure une barre oblique inverse de fin (\) :

  • Chemin d’accès d’un dossier monté, par exemple, Y :\MountX\
  • Lettre de lecteur, par exemple, D :\
  • Chemin d’accès GUID de volume du formulaire \\ ?\Volume{GUID}\ (où GUID identifie le volume)

[out] ppAsync

Pointeur vers un emplacement qui recevra un pointeur d’interface IVssAsync qui peut être utilisé pour récupérer l’état du processus de restauration. Une fois l’opération terminée, l’appelant doit libérer le pointeur d’interface en appelant la méthode IUnknown ::Release .

Valeur retournée

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

Valeur Meaning
S_OK
 L’opération a réussi.
E_ACCESSDENIED
 Le processus appelant a des privilèges insuffisants.
E_FAIL
 Une erreur interne s’affiche.
E_INVALIDARG
 L’un des paramètres passés n’est pas valide.
E_NOTIMPL
 Le fournisseur du volume ne prend pas en charge les opérations de restauration.
E_OUTOFMEMORY
 L’appelant est hors mémoire ou d’autres ressources système.
E_POINTER
 L’un des paramètres de pointeur requis est NULL.
VSS_E_OBJECT_NOT_FOUND
 Le paramètre pwszVolume n’est pas un volume valide.
VSS_E_VOLUME_NOT_SUPPORTED
 L’annulation n’est pas prise en charge sur ce volume.

Remarques

L’opération de restauration continue même si l’ordinateur est redémarré et ne peut pas être annulé ou annulé, sauf en restaurant une sauvegarde créée à l’aide d’une autre méthode. Méthode QueryStatus sur le retour
L’interface IVssAsync ne peut pas retourner VSS_S_ASYNC_CANCELLED car l’opération de restauration ne peut pas être annulée une fois qu’elle a démarré.

Spécifications

Requirement Valeur
Client minimum requis Windows Vista avec SP1 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008, Windows Server 2003 avec SP1 [applications de bureau uniquement]
plateforme cible Fenêtres
Header vsbackup.h (include VsBackup.h, Vss.h, VsWriter.h)
Library VssApi.lib

Voir aussi

IVssAsync

IVssBackupComponents

IVssBackupComponents ::RevertToSnapshot

  • Last updated on