Partager via

Méthode IVssSoftwareSnapshotProvider ::QueryRevertStatus (vsprov.h)

  • Article

Retourne un pointeur d’interface IVssAsync qui peut être utilisé pour déterminer la status 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 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\
  • Lettre de lecteur, par exemple, D :\
  • Chemin d’accès GUID de volume de la forme \\ ?\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 les status de l’opération 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

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

Valeur Signification
S_OK
 La status de l’opération de restauration a été correctement interrogée.
E_ACCESSDENIED
 L’appelant ne dispose pas de privilèges de sauvegarde suffisants ou n’est pas administrateur.
E_INVALIDARG
 L’une des valeurs de paramètre n’est pas valide.
E_OUTOFMEMORY
 L’appelant n’a pas de mémoire ou d’autres ressources système.
VSS_E_OBJECT_NOT_FOUND
 Le paramètre pwszVolume ne spécifie pas de volume valide.
VSS_E_VOLUME_NOT_SUPPORTED
 L’opération de restauration 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 qui a été créée à l’aide d’une autre méthode. La méthode IVssAsync ::QueryStatus 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é.

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
Bibliothèque VssApi.lib

Voir aussi

IVssSoftwareSnapshotProvider