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

Article
08/27/2023

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