Méthode IBackgroundCopyManager ::EnumJobs (bits.h)

Article
02/28/2024

Récupère un pointeur d’interface vers un objet énumérateur que vous utilisez pour énumérer les travaux dans la file d’attente de transfert. L’ordre des travaux dans l’énumérateur est arbitraire.

Syntaxe

HRESULT EnumJobs(
  [in]  DWORD                   dwFlags,
  [out] IEnumBackgroundCopyJobs **ppEnum
);

Paramètres

[in] dwFlags

Spécifie les travaux à inclure dans l’énumération. Si dwFlags est défini sur 0, l’utilisateur reçoit tous les travaux qu’il possède dans la file d’attente de transfert. Le tableau suivant répertorie les options d’énumération.

Option	Signification
BG_JOB_ENUM_ALL_USERS	Inclut tous les travaux de la file d’attente de transfert : ceux appartenant à l’utilisateur et ceux appartenant à d’autres personnes. L’utilisateur doit être administrateur pour utiliser cet indicateur.

[out] ppEnum

Pointeur d’interface IEnumBackgroundCopyJobs que vous utilisez pour énumérer les travaux dans la file d’attente de transfert. Le contenu de l’énumérateur dépend de la valeur de dwFlags. Relâchez ppEnumJobs lorsque vous avez terminé.

Valeur retournée

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

Code de retour	Description
S_OK	Objet énumérateur généré avec succès.
E_ACCESSDENIED	L’utilisateur doit être administrateur ou appartenir à un groupe d’administrateurs pour énumérer les travaux appartenant à un autre utilisateur.

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

IBackgroundCopyJob ::EnumFiles

IBackgroundCopyManager ::GetJob

IEnumBackgroundCopyJobs

Partager via