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 |
|---|---|
|
L’état du travail a été récupéré avec succès. |
|
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