Freigeben über


IBackgroundCopyManager::EnumJobs-Methode (bits.h)

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