Méthode IVdsAsync ::QueryStatus (vdshwprv.h)

[À compter de Windows 8 et Windows Server 2012, l’interface COM du service de disque virtuel est remplacée par l’API gestion du stockage Windows.]

Retourne lorsque l’opération asynchrone est en cours, ou si elle s’est terminée avec succès ou a échoué.

Syntaxe

HRESULT QueryStatus(
  [out] HRESULT *pHrResult,
  [out] ULONG   *pulPercentCompleted
);

Paramètres

[out] pHrResult

Adresse d’un HRESULT pour l’opération asynchrone passée par l’appelant. Si l’opération est en cours, la valeur est VDS_E_OPERATION_PENDING. Si l’opération est terminée, la valeur est le HRESULT retourné de l’opération.

[out] pulPercentCompleted

Adresse d’un ULONG transmis par l’appelant, représentant le status de l’opération asynchrone, donné sous forme de pourcentage. Si l’opération est en cours, la valeur est comprise entre 0 et 99. Si l’opération est terminée, la valeur est 100. Si la progression de l’opération ne peut pas être estimée, la valeur est 0.

Valeur retournée

Cette méthode peut retourner des valeurs HRESULT standard, telles que E_INVALIDARG ou E_OUTOFMEMORY, et des valeurs de retour spécifiques à VDS. Il peut également retourner des codes d’erreur système convertis à l’aide de la macro HRESULT_FROM_WIN32 . Les erreurs peuvent provenir de VDS lui-même ou du fournisseur VDS sous-jacent utilisé. Les valeurs de retour possibles sont les suivantes.

Code/valeur de retour	Description
S_OK	L’opération est en cours ou est terminée.
VDS_E_OPERATION_PENDING 0x80042409L	L’opération est en cours.

Remarques

La méthode QueryStatus n’attend pas que l’opération se termine avant de retourner.

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	vdshwprv.h
Bibliothèque	Uuid.lib

Voir aussi

IVdsAsync