Méthode IVssBackupComponents ::QueryRevertStatus (vsbackup.h)

  • Article

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

Syntaxe

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

Paramètres

[in] pwszVolume

Chaîne de caractères larges terminée par null contenant le nom du volume. Le nom doit être 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\
  • Une lettre de lecteur, par exemple, D :\
  • Chemin d’accès guid du volume au format \\ ?\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 le status du processus de rétablissement. 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 Signification
S_OK
 L'opération a réussi.
E_ACCESSDENIED
 Le processus appelant a des privilèges insuffisants.
E_FAIL
 Il y a une erreur interne.
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 rétablissement.
E_OUTOFMEMORY
 L’appelant n’a plus de 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
 La restauration n’est pas prise en charge sur ce volume.

Remarques

L’opération de rétablissement se poursuit 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 retourné
L’interface IVssAsync ne peut pas retourner VSS_S_ASYNC_CANCELLED , car l’opération de rétablissement ne peut pas être annulée une fois qu’elle a démarré.

Configuration requise

Condition requise Valeur
Client minimal pris en charge 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 Windows
En-tête vsbackup.h (inclure VsBackup.h, Vss.h, VsWriter.h)
Bibliothèque VssApi.lib

Voir aussi

IVssAsync

IVssBackupComponents

IVssBackupComponents ::RevertToSnapshot