Partager via


IBackgroundCopyJob ::GetState, méthode (bits.h)

Récupère l’état du travail.

Syntaxe

HRESULT GetState(
  [out] BG_JOB_STATE *pVal
);

Paramètres

[out] pVal

État du travail. Par exemple, l’état indique si le travail est en erreur, en cours de transfert de données ou suspendu. Pour obtenir la liste des états du travail, consultez l’énumération BG_JOB_STATE .

Valeur retournée

Cette méthode retourne les valeurs HRESULT suivantes, ainsi que d’autres.

Code de retour Description
S_OK
L’état du travail a été récupéré avec succès.
E_INVALIDARG
Le paramètre pJobState ne peut pas être NULL.

Remarques

Si vous souhaitez savoir quand un travail est en erreur ou a transféré tous les fichiers du travail, vous pouvez utiliser cette méthode pour interroger l’état du travail ou vous inscrire pour recevoir une notification lorsque des événements se produisent. Pour plus d’informations sur l’inscription pour recevoir une notification d’événement, consultez l’interface IBackgroundCopyCallback .

Exemples

Consultez l’exemple de code de la méthode IBackgroundCopyManager ::GetJob .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP
Serveur minimal pris en charge Windows Server 2003
Plateforme cible Windows
En-tête bits.h
Bibliothèque Bits.lib
DLL QmgrPrxy.dll

Voir aussi

BG_JOB_STATE, Détermination de la status d’un travail, IBackgroundCopyCallback