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 transférant des données ou suspendu. Pour obtenir la liste des états de 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 Descriptif
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 pouvez vous inscrire pour recevoir une notification lorsque des événements se produisent. Pour plus d’informations sur l’inscription à la notification d’événement, consultez l’interface IBackgroundCopyCallback .

Examples

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

Spécifications

Requirement Valeur
Client minimum requis Windows XP
Serveur minimal pris en charge Windows Server 2003
plateforme cible Fenêtres
Header bits.h
Library Bits.lib
DLL QmgrPrxy.dll

Voir aussi

BG_JOB_STATE, Détermination de l’état d’un travail, IBackgroundCopyCallback