Partager via


Méthode IVssAsync::QueryStatus (vss.h)

La méthode QueryStatus interroge la status d’une opération asynchrone.

Syntaxe

HRESULT QueryStatus(
  [out] HRESULT *pHrResult,
  [out] INT     *pReserved
);

Paramètres

[out] pHrResult

Status de l’opération asynchrone qui a retourné l’objet IVssAsync actuel.

Tous les appels à QueryStatus pour tous les objets IVssAsync prennent en charge les codes status suivants.

Valeur Signification
VSS_S_ASYNC_CANCELLED
L’opération asynchrone a été annulée par un appel précédent à IVssAsync::Cancel.
VSS_S_ASYNC_FINISHED
L’opération asynchrone s’est terminée avec succès.
VSS_S_ASYNC_PENDING
L’opération asynchrone est toujours en cours d’exécution.
 

Des valeurs de retour supplémentaires peuvent être retournées, mais dépendent des codes de retour de la méthode qui a initialement retourné l’objet IVssAsync .

[out] pReserved

La valeur de ce paramètre doit être NULL.

Valeur retournée

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

Valeur Signification
S_OK
L’opération de requête a réussi.
E_ACCESSDENIED
L’opération de requête a échoué, car l’utilisateur ne disposait pas des privilèges appropriés.
E_INVALIDARG
Le pointeur vers la variable utilisée pour contenir la valeur de retour pHrResult est NULL ou n’est pas un emplacement mémoire valide.
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

En cas d’erreur au cours d’une opération asynchrone, QueryStatus retourne le même code d’erreur que la méthode qui a initialement retourné l’objet IVssAsync .

Pour obtenir la liste complète des valeurs renvoyées pour un objet IVssAsync::QueryStatus retourné par une méthode spécifique, consultez les codes d’erreur documentés pour cette méthode.

Configuration requise

   
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête vss.h
Bibliothèque VssApi.lib

Voir aussi

IVssAsync

IVssBackupComponents::D oSnapshotSet

IVssBackupComponents::GatherWriterMetadata

IVssBackupComponents::GatherWriterStatus

IVssBackupComponents::ImportSnapshots

IVssBackupComponents::P ostRestore

IVssBackupComponents::P reRestore

IVssBackupComponents::P repareForBackup