IBackgroundCopyManager::EnumJobs-Methode (bits.h)

Artikel
02/28/2024

Ruft einen Schnittstellenzeiger auf ein Enumeratorobjekt ab, das Sie zum Aufzählen der Aufträge in der Übertragungswarteschlange verwenden. Die Reihenfolge der Aufträge im Enumerator ist beliebig.

Syntax

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

Parameter

[in] dwFlags

Gibt an, wessen Aufträge in die Enumeration eingeschlossen werden sollen. Wenn dwFlags auf 0 festgelegt ist, erhält der Benutzer alle Aufträge, die er in der Übertragungswarteschlange besitzt. In der folgenden Tabelle sind die Enumerationsoptionen aufgeführt.

Option	Bedeutung
BG_JOB_ENUM_ALL_USERS	Schließt alle Aufträge in die Übertragungswarteschlange ein – diejenigen, die dem Benutzer gehören und die anderen gehören. Der Benutzer muss ein Administrator sein, um dieses Flag verwenden zu können.

[out] ppEnum

Ein IEnumBackgroundCopyJobs-Schnittstellenzeiger , mit dem Sie die Aufträge in der Übertragungswarteschlange auflisten. Der Inhalt des Enumerators hängt vom Wert von dwFlags ab. Geben Sie ppEnumJobs frei, wenn Sie fertig sind.

Rückgabewert

Diese Methode gibt die folgenden HRESULT-Werte sowie andere zurück.

Rückgabecode	Beschreibung
S_OK	Enumeratorobjekt erfolgreich generiert.
E_ACCESSDENIED	Der Benutzer muss Administrator oder Mitglied einer Administratorgruppe sein, um Aufträge im Besitz eines anderen Benutzers aufzulisten.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP
Unterstützte Mindestversion (Server)	Windows Server 2003
Zielplattform	Windows
Kopfzeile	bits.h
Bibliothek	Bits.lib
DLL	QmgrPrxy.dll

Weitere Informationen

IBackgroundCopyJob::EnumFiles

IBackgroundCopyManager::GetJob

IEnumBackgroundCopyJobs

Share via